TreeView_GetItem 宏 (commctrl.h)

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

语法

void TreeView_GetItem(
   hwnd,
   pitem
);

参数

hwnd

类型: HWND

树视图控件的句柄。

pitem

类型: LPTVITEM

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

返回值

备注

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

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

要求

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