Header_GetItem宏 (commctrl.h)

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

语法

void Header_GetItem(
   hwndHD,
   i,
   phdi
);

参数

hwndHD

类型： HWND

标头控件的句柄。

i

类型： int

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

phdi

类型： LPHDITEM

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

返回值

无

备注

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

Header_GetItem宏定义如下：

#define Header_GetItem(hwndHD, index, phdi)      \

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

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

要求

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