MFC 树形控件CTreeCtrl类

简介: MFC 树形控件CTreeCtrl类

MFC为树形控件提供了CTreeCtrl类,它封装了树形控件的所有操作。


API


树形控件创建:Create()


树形控件的创建也是有两种方式,一种是在对话框模板中直接拖入Tree Control控件创建,另一种就是通过CTreeCtrl类的Create成员函数创建。


前者拖控件,只要你再在类向导里为控件添加一个控件类型的变量,系统就会调用一系列生成函数默认生成该变量对象,


下面Create函数讲的是后者的创建。


Create成员函数的原型如下:


virtual BOOL Create(
       DWORD dwStyle,
       const RECT& rect,
       CWnd* pParentWnd,
       UINT nID 
);


参数:


  • dwStyle指定树形控件风格的组合(参数详情见下文表格风格表格)


  • rect指定树形控件窗口的位置和大小


  • pParentWnd为指向树形控件父窗口的指针


  • nID指定树形控件的ID。


dwStyle可选项:


image.png


同样,动态创建树形控件时,除了能够指定上述风格的组合外,一般还要指定WS_CHILD和WS_VISIBLE风格。


在对话框模板中直接拖入Tree Control创建树形控件时,可以在树形控件的属性页中设置其风格,与上面的风格是对应的,例如,属性Has Lines对应的就是TVS_HASLINES风格。


设置节点显示图标:SetImageList()


CImageList* SetImageList(CImageList * pImageList,int nImageListType);


如果树节点需要显示图标时,则必须先创建一个CImageList类的对象,并为其添加多个图像组成一个图像序列,然后调用SetImageList函数为树形控件设置图像序列,在用InsertItem插入节点时传入所需图像在图像序列中的索引即可。


  • pImageList为指向图像序列类CImageList的对象的指针,若为NULL则删除树形控件的所有图像。


  • nImageListType指定图像序列的类型,可以是TVSIL_NORMAL(普通图像序列)或TVSIL_STATE(状态图像序列,用图像表示节点的状态)。


获取节点数量:GetCount()


UINT GetCount( ) const;


获取树形控件中节点的数量。


获取树形控件中某节点的附加32位数据:GetItemData()


DWORD_PTR GetItemData(HTREEITEM hItem) const;


获取树形控件中某个指定节点的附加32位数据。


  • hItem为指定的树节点的句柄。


为树形控件中某个指定节点设置附加的32位数据:SetItemData()


BOOL SetItemData(HTREEITEM hItem,DWORD_PTR dwData);


为树形控件中某个指定节点设置附加的32位数据。


  • hItem为指定的树节点的句柄。


  • dwData为要设置的32位数据。


获取树形控件中某个指定节点的标签文本:GetItemText()


CString GetItemText(HTREEITEM hItem) const;


获取树形控件中某个指定节点的标签文本。参数hItem同上。


返回值是包含标签文本的字符串。


为树形控件中某个指定节点设置标签文本:SetItemText()


BOOL SetItemText(HTREEITEM hItem,LPCTSTR lpszItem);


为树形控件中某个指定节点设置标签文本。


参数:


  • hItem同上


  • lpszItem为包含标签文本的字符串的指针。


获取树形控件中某个指定节点的下一个兄弟节点:GetNextSiblingItem()


HTREEITEM GetNextSiblingItem(HTREEITEM hItem) const;


获取树形控件中某个指定节点的下一个兄弟节点。


参数hItem同上。


返回值是下一个兄弟节点的句柄。


获取树形控件中某个指定节点的上一个兄弟节点:GetPrevSiblingItem()


HTREEITEM GetPrevSiblingItem(HTREEITEM hItem) const;


获取树形控件中某个指定节点的上一个兄弟节点。


参数hItem同上。


返回值是上一个兄弟节点的句柄。


获取树形控件中某个指定节点的父节点:GetParentItem()


HTREEITEM GetParentItem(HTREEITEM hItem) const;


获取树形控件中某个指定节点的父节点。


参数hItem同上。


返回值是父节点的句柄。


获取树形控件根节点的句柄:GetRootItem()


HTREEITEM GetRootItem( ) const;


获取树形控件根节点的句柄。


获取树形控件当前选中节点的句柄:GetSelectedItem()


HTREEITEM GetSelectedItem( ) const;


获取树形控件当前选中节点的句柄。


删除树形控件中的所有节点:DeleteAllItems()


BOOL DeleteAllItems( );


删除树形控件中的所有节点。删除成功则返回TRUE,否则返回FALSE。


删除树形控件中的某个节点:DeleteItem()


BOOL DeleteItem(HTREEITEM hItem);


删除树形控件中的某个节点。


参数:


  • hItem为要删除的节点的句柄。


返回值:删除成功则返回TRUE,否则返回FALSE。


在树形控件中插入一个新节点:InsertItem()


HTREEITEM InsertItem(LPCTSTR lpszItem,int nImage,int nSelectedImage,HTREEITEM hParent


在树形控件中插入一个新节点。


  • lpszItem为新节点的标签文本字符串的指针,


  • nImage为新节点的图标在树形控件图像序列中的索引,


  • nSelectedImage为新节点被选中时的图标在图像序列中的索引,


  • hParent为插入节点的父节点的句柄,


  • hInsertAfter为新节点的前一个节点的句柄,即新节点将被插入到hInsertAfter节点之后。


选中指定的树节点:SelectItem()


BOOL SelectItem(HTREEITEM hItem);


选中指定的树节点。


参数:


  • hItem为要选择的节点的句柄。


返回值:若成功则返回TRUE,否则返回FALSE

相关文章
|
区块链
18 MFC - 树控件 CTreeCtrl
18 MFC - 树控件 CTreeCtrl
45 0
|
BI
17 MFC - 列表控件 CListCtrl
17 MFC - 列表控件 CListCtrl
69 0
MFC自定义环形进度条的实现
MFC自定义环形进度条的实现
436 0
MFC自定义环形进度条的实现
|
索引
MFC中组合框CComboBox的使用
假如添加三行数据,其中当选择前两行时,提示自定义提示框信息,选择第三行时,提示当前字符串的内容,实现如下: void Cuse_demo_dllDlg::OnCbnSelchangeCombo1(){ int pos=m_combo.
1107 0