用于向树状控件中插入一个选项。该函数有四种格式:
HTREEITEM InsertItem(LPTV_INSERTSTRUCT lpInsertStruct);
或
HTREEITEM InsertItem(UNIT nMask,LPCTSTR lpszItem,
int nImage,int nSelectedImage,
UNIT nState,UNIT nStateMark,
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 hParent=TVI_LAST);
在第一种格式中,lpInsertStruct参数作为一个指向TV_INSERTSTRUCT 结构的指针,其中包含插入选项的各种信息。
TV_INSERTSTRUCT 结构说明如下:
typedef struct_TV_INSERTSTRUCT{tvins
HTREEITEM hParent; //指定父选项
HTREEITEM hInsertAfter; //指定插入到那个选项的后面
TV_ITEM item; //选项的TV_ITEM结构
}TV_INSERTSTRUCT ,FAR*LPTV_INSERTSTRUCT ;
在第二种格式中,函数一项一项的设置插入选项的位置很属性。
在第三种格式中,hParent参数和hInsertAfter分别指定插入的选项的父选项和前驱选项;lpszItem指定插入选项的标签。
第四种格式比第三种格式多了两个参数,其中nImage和nSelectImage参数用于指定插入选项的图标索引。