標頭控件

本節包含與標頭控件搭配使用之程式設計專案的相關信息。

綜述

主題	內容
關於標頭控件的	標頭控件是通常位於文字或數字數據行上方的視窗。 它包含每個數據行的標題，而且可以分割成部分。
使用標頭控件	本主題提供標頭控件的實作詳細數據和程式代碼範例。

巨集

主題	內容
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 訊息的形式傳送。

常數

主題	內容
標頭控件樣式	標頭控件有一些樣式，如本節所述，可決定控件的外觀和行為。 當您建立標頭控件時，會設定初始樣式。