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