Header_GetItem 宏 (commctrl.h)

获取有关标头控件中的项的信息。 可以使用此宏或显式发送 HDM_GETITEM 消息。

语法

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

参数

hwndHD

类型:HWND

标头控件的句柄。

i

类型:int

要为其检索信息的项的索引。

phdi

类型:LPHDITEM

指向 HDITEM 结构的指针。 发送消息时,掩码 成员指示请求的信息类型。 消息返回时,其他成员将收到请求的信息。 如果 掩码 成员指定零,则消息 TRUE 返回,但不会将任何信息复制到结构。

返回值

类型:BOOL

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

言论

如果在 掩码HDITEM 结构的成员中设置HDI_TEXT标志,则控件可能会更改结构 pszText 成员指向新文本,而不是使用请求的文本填充缓冲区。 应用程序不应假定文本将始终放置在请求的缓冲区中。

Header_GetItem 宏的定义如下:

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))

要求

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