ヘッダー コントロール

このセクションでは、ヘッダー コントロールで使用されるプログラミング要素について説明します。

概要

トピック	内容
ヘッダー コントロールについて	ヘッダー コントロールは、通常はテキストまたは数値の列の上に配置されるウィンドウです。 列ごとにタイトルが含まれており、コントロールを複数のパーツに分割することができます。
ヘッダー コントロールの使用	このトピックには、ヘッダー コントロールの実装の詳細とコード例を掲載しています。

マクロ

トピック	内容
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 メッセージの形式で送信されます。

定数

トピック	内容
ヘッダー コントロール スタイル	このセクションで説明しているように、ヘッダー コントロールには、コントロールの外観と動作を決定するスタイルが多数用意されています。 初期スタイルは、ヘッダー コントロールを作成するときに設定します。