次の方法で共有

ヘッダー コントロール

  • [アーティクル]

このセクションには、ヘッダー コントロールで使用されるプログラミング要素に関する情報が含まれています。

概要

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

マクロ

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

定数

話題 内容
ヘッダー コントロール のスタイル ヘッダー コントロールには、コントロールの外観と動作を決定するさまざまなスタイルがあります。このセクションで説明します。 ヘッダー コントロールを作成するときに、初期スタイルを設定します。