标头控件

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

概述

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

主题 目录
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_GetImageListHeader_GetStateImageList 宏。
HDM_GETITEM 获取有关标头控件中的项的信息。 可以显式发送此消息或使用 Header_GetItem 宏。
HDM_GETITEMCOUNT 获取标头控件中的项计数。 可以显式发送此消息或使用 Header_GetItemCount 宏。
HDM_GETITEMDROPDOWNRECT 获取具有样式HDF_SPLITBUTTON的标题项的拆分按钮的边界矩形。 显式发送此消息或使用Header_GetItemDropDownRect macro 发送。
HDM_GETITEMRECT 获取标头控件中给定项的边界矩形。 可以显式发送此消息或使用 Header_GetItemRect 宏。
HDM_GETORDERARRAY 获取标头控件中项的当前从左到右的顺序。 可以显式发送此消息或使用 Header_GetOrderArray 宏。
HDM_GETOVERFLOWRECT 当在标头控件上设置 HDS_OVERFLOW 样式并且溢出按钮可见时,获取溢出按钮的边界矩形。 显式发送此消息或使用Header_GetOverflowRect macro 发送。
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_SetImageListHeader_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 消息的形式发送。

常量

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