VC++开发GIS系统（63）简析CTreeCtrl中的InsertItem函数

在上文《VC++开发GIS系统（62）停靠窗口中添加树形控件（CTreeCtrl）》中我简单介绍了在dockablepane中添加树形控件的方法，其中用到了一个InsertItem的函数，这个函数在后面中会常用到，这里就做一个简单的说明。

函数原型

HTREEITEM InsertItem(
LPTVINSERTSTRUCT lpInsertStruct 
);

HTREEITEM InsertItem(
UINT nMask,
LPCTSTR lpszItem,
int nImage,
int nSelectedImage,
UINT nState,
UINT nStateMask,
LPARAM lParam,
HTREEITEM hParent,
HTREEITEM hInsertAfter 
);

HTREEITEM InsertItem(
LPCTSTR lpszItem,
HTREEITEM hParent = TVI_ROOT,
HTREEITEM hInsertAfter = TVI_LAST 
);

HTREEITEM InsertItem(
LPCTSTR lpszItem,
int nImage,
int nSelectedImage,
HTREEITEM hParent = TVI_ROOT,
HTREEITEM hInsertAfter = TVI_LAST
);

调用示例

以上文中的方法为例

HTREEITEM prjRoot = m_wndPrjView.InsertItem(_T("默认工程"), 0, 0);
HTREEITEM hSrc = m_wndPrjView.InsertItem(_T("点文件"), 0, 0, prjRoot);

其中_T("点文件")和_T("默认工程")对应的LPCTSTR lpszItem，也就是节点名称。后面的2个0分别代表int nImage和int nSelectedImage,表示默认情况和选中情况下节点的图片ID，关于图片ID的知识可以参考，《VC++开发GIS系统（36）使用IconWorkshop更改程序图标》和《VC++开发GIS系统（37）利用IconWorkshop添加输入点按钮》。后面HTREEITEM hParent = TVI_ROOT参数表示父节点，没有传入则默认root节点；HTREEITEM hInsertAfter = TVI_LAST表示插入哪个节点后面。

下图演示int nImage和int nSelectedImage的调用效果：