TreeView_GetItem宏 (commctrl.h)

检索树视图项的某些或全部属性。 可以使用此宏或显式发送 TVM_GETITEM 消息。

语法

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

参数

hwnd

类型:HWND

树视图控件的句柄。

pitem

类型:LPTVITEM

指向 TVITEM 结构的指针,该结构指定要检索和接收有关项的信息。 使用 版本 4.71 及更高版本,可以改用 TVITEMEX 结构。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

发送 TVM_GETITEM 消息时,TVITEMTVITEMEX 结构的 hItem 成员标识要检索信息的项,掩码 成员指定要检索的属性。

如果在 TVITEMTVITEMEX 结构的 掩码 成员中设置TVIF_TEXT标志,pszText 成员必须指向有效缓冲区,cchTextMax 成员必须设置为该缓冲区中的字符数。 返回的文本不一定存储在应用程序传递的原始缓冲区中。 pszText 可能会指向新缓冲区中的文本,而不是将其放置在旧缓冲区中。

要求

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