Header_InsertItem 宏 (commctrl.h)

将新项插入标头控件。 可以使用此宏或显式发送 HDM_INSERTITEM 消息。

语法

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

参数

hwndHD

类型:HWND

标头控件的句柄。

i

类型:int

要在其之后插入新项的项的索引。 如果 i 大于或等于控件中的项数,则新项将插入标头控件的末尾。 如果 i 为零,则新项将插入到标头控件的开头。

phdi

类型: LPHDITEM

指向包含新项信息的 HDITEM 结构的指针。

返回值

类型:int

如果成功,则返回新项的索引,否则返回 -1。

言论

Header_InsertItem 宏的定义如下:

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

要求

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