TVINSERTSTRUCTA 结构 (commctrl.h)

包含用于将新项添加到树视图控件的信息。 此结构与 TVM_INSERTITEM 消息一起使用。 结构与 TV_INSERTSTRUCT 结构相同,但已重命名为遵循当前命名约定。

语法

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

成员

hParent

类型: HTREEITEM

父项的句柄。 如果此成员是TVI_ROOT值或 NULL,则将该项插入到树视图控件的根目录中。

hInsertAfter

类型: HTREEITEM

要在其后插入新项的项的句柄,或以下值之一:

含义
TVI_FIRST
在列表的开头插入项。
TVI_LAST
在列表末尾插入项。
TVI_ROOT
将项添加为根项。
TVI_SORT
按字母顺序将项插入列表中。

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

类型: TVITEMEX

版本 4.71TVITEMEX 结构,其中包含有关要添加的项的信息。

DUMMYUNIONNAME.item

类型: TVITEM

TVITEM 结构,其中包含有关要添加的项的信息。

注解

此结构中的联合已更新为适用于不支持无名称联合的编译器。 如果编译器不支持无名称联合,请在包含 commctrl.h 头文件之前定义 NONAMELESSUNION 标记。

重要 使用 TVI_LAST将项插入到已包含大量项的树视图节点可能需要很长时间,从而导致应用程序停止响应,直到插入操作完成。
 

注意

commctrl.h 标头将 TVINSERTSTRUCT 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h