标头控件

本部分包含有关与标头控件一起使用的编程元素的信息。

概述

主题	目录
关于标头控件	标头控件是一个窗口，通常位于文本或数字列的上方。 它包含每列的标题，可以分为多个部分。
使用标头控件	本主题提供标头控件的实施详细信息和代码示例。

宏

主题	目录
Header_ClearAllFilters	清除给定标头控件的所有筛选器。 可以使用此宏，或显式发送 HDM_CLEARFILTER 消息。
Header_ClearFilter	清除给定标头控件的筛选器。 可以使用此宏，或显式发送 HDM_CLEARFILTER 消息。
Header_CreateDragImage	在现有标头控件中创建项图像的透明版本。 可以使用此宏，或显式发送 HDM_CREATEDRAGIMAGE 消息。
Header_DeleteItem	从标题控件中删除项。 可以使用此宏，或显式发送 HDM_DELETEITEM 消息。
Header_EditFilter	当筛选器按钮具有焦点时，将输入焦点移动到编辑框。
Header_GetBitmapMargin	获取现有标头控件中位图的边距宽度（以像素为单位）。 可以使用此宏，或显式发送 HDM_GETBITMAPMARGIN 消息。
Header_GetFocusedItem	获取具有该焦点的标头控件中的项。 使用此宏，或显式发送 HDM_GETFOCUSEDITEM 消息。
Header_GetImageList	获取为现有标头控件设置的图像列表的句柄。 可以使用此宏，或显式发送 HDM_GETIMAGELIST 消息。
Header_GetItem	获取有关标头控件中的项的信息。 可以使用此宏，或显式发送 HDM_GETITEM 消息。
Header_GetItemCount	获取标头控件中项的计数。 可以使用此宏，或显式发送 HDM_GETITEMCOUNT 消息。
Header_GetItemDropDownRect	获取标头控件中指定项的下拉按钮的坐标。 标头控件的类型必须为 HDF_SPLITBUTTON。 使用此宏，或显式发送 HDM_GETITEMDROPDOWNRECT 消息。
Header_GetItemRect	获取标头控件中给定项的边框。 可以使用此宏，或显式发送 HDM_GETITEMRECT 消息。
Header_GetOrderArray	获取标头控件中当前从左到右排序的项。 可以使用此宏，或显式发送 HDM_GETORDERARRAY 消息。
Header_GetOverflowRect	获取指定标头控件的下拉溢出区域的坐标。 标头控件的类型必须为 HDF_SPLITBUTTON。 使用此宏，或显式发送 HDM_GETOVERFLOWRECT 消息。
Header_GetStateImageList	获取为现有标头控件状态设置的图像列表的句柄。
Header_GetUnicodeFormat	获取控件的 Unicode 字符格式标志。 可以使用此宏或显式发送 HDM_GETUNICODEFORMAT 消息。
Header_InsertItem	将新项插入标题控件。 可以使用此宏，或显式发送 HDM_INSERTITEM 消息。
Header_Layout	检索父窗口中标头控件的正确大小和位置。 可以使用此宏，或显式发送 HDM_LAYOUT 消息。
Header_OrderToIndex	根据项在标头控件中的顺序检索项的索引值。 可以使用此宏，或显式发送 HDM_ORDERTOINDEX 消息。
Header_SetBitmapMargin	设置现有标头控件中位图的边距宽度。 可以使用此宏，或显式发送 HDM_SETBITMAPMARGIN 消息。
Header_SetFilterChangeTimeout	设置筛选器属性发生更改与发布 HDN_FILTERCHANGE 通知之间的超时间隔。 可以使用此宏或显式发送 HDM_SETFILTERCHANGETIMEOUT 消息。
Header_SetFocusedItem	将焦点设置为标头控件中的指定项。 使用此宏，或显式发送 HDM_SETFOCUSEDITEM 消息。
Header_SetHotDivider	更改标头项之间的分隔线的颜色，以指示外部拖放操作的目标。 可以使用此宏，或显式发送 HDM_SETHOTDIVIDER 消息。
Header_SetImageList	将图像列表分配给现有标头控件。 可以使用此宏，或显式发送 HDM_SETIMAGELIST 消息。
Header_SetItem	设置标题控件中指定项的属性。 可以使用此宏，或显式发送 HDM_SETITEM 消息。
Header_SetOrderArray	设置标头项从左到右的顺序。 可以使用此宏，或显式发送 HDM_SETORDERARRAY 消息。
Header_SetStateImageList	将图像列表分配给现有标头控件状态。
Header_SetUnicodeFormat	设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集，而无需重新创建控件。 可以使用此宏或显式发送 HDM_SETUNICODEFORMAT 消息。

消息

主题	目录
HDM_CLEARFILTER	清除给定标头控件的筛选器。 可以显式发送此消息，也可以使用 Header_ClearFilter 宏发送。
HDM_CREATEDRAGIMAGE	创建项图像的半透明版本，以用作拖动图像。 可以显式发送此消息，也可以使用 Header_CreateDragImage 宏发送。
HDM_DELETEITEM	从标题控件中删除项。 可以显式发送此消息，也可以使用 Header_DeleteItem 宏发送。
HDM_EDITFILTER	当筛选器按钮具有焦点时，将输入焦点移动到编辑框。
HDM_GETBITMAPMARGIN	获取标头控件的位图边距的宽度。 可以显式发送此消息，也可以使用 Header_GetBitmapMargin 宏发送。
HDM_GETFOCUSEDITEM	获取具有该焦点的标头控件中的项。 显式发送此消息，也可以使用 Header_GetFocusedItem 宏发送。 窗口通过其 WindowProc 函数接收此消息。
HDM_GETIMAGELIST	获取为现有标头控件设置的图像列表的句柄。 可以显式发送此消息或使用 Header_GetImageList 或 Header_GetStateImageList 宏。
HDM_GETITEM	获取有关标头控件中的项的信息。 可以显式发送此消息，也可以使用 Header_GetItem 宏发送。
HDM_GETITEMCOUNT	获取标头控件中项的计数。 可以显式发送此消息，也可以使用 Header_GetItemCount 宏发送。
HDM_GETITEMDROPDOWNRECT	获取具有样式 HDF_SPLITBUTTON 的标头项的拆分按钮的边框。 显式发送此消息或使用 Header_GetItemDropDownRect 宏发送。
HDM_GETITEMRECT	获取标头控件中给定项的边框。 可以显式发送此消息，也可以使用 Header_GetItemRect 宏。
HDM_GETORDERARRAY	获取标头控件中当前从左到右排序的项。 可以显式发送此消息，或使用 Header_GetOrderArray 宏。
HDM_GETOVERFLOWRECT	获取在标头控件上设置 HDS_OVERFLOW 样式并且溢出按钮可见时溢出按钮的边框。 显式发送此消息或使用 Header_GetOverflowRect 宏发送。
HDM_GETUNICODEFORMAT	获取控件的 Unicode 字符格式标志。 可以显式发送此消息，也可以使用 Header_GetUnicodeFormat 宏。
HDM_HITTEST	测试一个点以确定哪个标头项（如果有）位于指定点。
HDM_INSERTITEM	将新项插入标题控件。 可以显式发送此消息，也可以使用 Header_InsertItem 宏。
HDM_LAYOUT	检索用于在父窗口的目标矩形中设置标头控件的大小和位置的信息。 可以显式发送此消息，也可以使用 Header_Layout 宏。
HDM_ORDERTOINDEX	根据项在标头控件中的顺序检索项的索引值。 可以显式发送此消息，也可以使用 Header_OrderToIndex 宏。
HDM_SETBITMAPMARGIN	设置现有标头控件中位图的边距宽度（以像素为单位指定）。 可以显式发送此消息，也可以使用 Header_SetBitmapMargin 宏。
HDM_SETFILTERCHANGETIMEOUT	设置筛选器属性发生更改与发布 HDN_FILTERCHANGE 通知之间的超时间隔。 可以显式发送此消息，也可以使用 Header_SetFilterChangeTimeout 宏。
HDM_SETFOCUSEDITEM	将焦点设置为标头控件中的指定项。 显式发送此消息，也可以使用 Header_SetFocusedItem 宏。
HDM_SETHOTDIVIDER	更改标头项之间的分隔线的颜色，以指示外部拖放操作的目标。 可以显式发送此消息，也可以使用 Header_SetHotDivider 宏发送。
HDM_SETIMAGELIST	将图像列表分配给现有标头控件。 可以显式发送此消息或使用 Header_SetImageList 或 Header_SetStateImageList 宏。
HDM_SETITEM	设置标题控件中指定项的属性。 可以显式发送此消息，也可以使用 Header_SetItem 宏。
HDM_SETORDERARRAY	设置标头项从左到右的顺序。 可以显式发送此消息，或使用 Header_SetOrderArray 宏。
HDM_SETUNICODEFORMAT	设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集，而无需重新创建控件。 可以显式发送此消息，也可以使用 Header_SetUnicodeFormat 宏。
HDM_TRANSLATEACCELERATOR	未实现。

通知

主题	目录
HDN_BEGINDRAG	当某个项开始拖动操作时，由标头控件发送。 此通知代码仅由设置为 HDS_DRAGDROP 样式的标头控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_BEGINFILTEREDIT	通知标头控件的父窗口筛选器编辑已开始。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_BEGINTRACK	通知标头控件的父窗口，用户已开始在控件中拖动分隔符（也就是说，当鼠标光标位于标头控件的分隔符上时用户按下了鼠标左键）。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_DIVIDERDBLCLICK	通知标头控件的父窗口，用户双击控件的分隔区。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_DROPDOWN	单击标头控件上的下拉箭头时，由标头控件发送到其父级。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ENDDRAG	当某个项结束拖动操作时，由标头控件发送。 此通知代码作为 WM_NOTIFY 消息发送。 仅设置为 HDS_DRAGDROP 样式的标头控件发送此通知。
HDN_ENDFILTEREDIT	通知标头控件的父窗口筛选器编辑已结束。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ENDTRACK	通知标头控件的父窗口，用户已完成拖动分隔符。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_FILTERBTNCLICK	单击筛选器按钮或响应 HDM_SETITEM 消息时通知标头控件的父窗口。
HDN_FILTERCHANGE	通知标头控件的父窗口正在更改或编辑标头控件筛选器的属性。
HDN_GETDISPINFO	当控件需要有关回调标头项的信息时，发送到标头控件的所有者。 此通知代码作为 WM_NOTIFY 消息发送。
HDN_ITEMCHANGED	通知标头控件的父窗口，标头项的属性已更改。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ITEMCHANGING	通知标头控件的父窗口，标头项的属性即将更改。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ITEMCLICK	通知标头控件的父窗口，用户单击该控件。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ITEMDBLCLICK	通知标头控件的父窗口，用户双击该控件。 此通知代码以 WM_NOTIFY 消息的形式发送。 仅设置为 HDS_BUTTONS 样式的标头控件发送此通知。
HDN_ITEMKEYDOWN	通知标头控件的父窗口已按下某个键并选中某项。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_ITEMSTATEICONCLICK	通知标头控件的父窗口，用户单击某项的状态图标。
HDN_OVERFLOWCLICK	单击标头的溢出按钮时，由标头控件发送到其父级。 此通知代码以 WM_NOTIFY 消息的形式发送。
HDN_TRACK	通知标头控件的父窗口，用户正在拖动标头控件中的分隔符。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_CUSTOMDRAW（标头）	由标头控件发送，以通知其父窗口有关绘制操作的信息。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RCLICK（标头）	通知树视图控件的父窗口，用户已在控件中单击鼠标右键。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RELEASEDCAPTURE（标头）	通知标头控件的父窗口，控件正在释放鼠标捕获。 此通知代码以 WM_NOTIFY 消息的形式发送。

常量

主题	目录
标题控件样式	标头控件具有许多样式，如本部分中所述，用于确定控件的外观和行为。 在创建标头控件时设置初始样式。