HDITEMA 構造体 (commctrl.h)

  • [アーティクル]

ヘッダー コントロール内の項目に関する情報を格納します。 この構造体は 、HD_ITEM 構造体よりも優先されます。

構文

typedef struct _HD_ITEMA {
  UINT    mask;
  int     cxy;
  LPSTR   pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMA, *LPHDITEMA;

メンバー

mask

型: UINT

有効なデータを含む他の構造体メンバー、または入力する必要がある構造体メンバーを示すフラグ。 このメンバーには、次の値の組み合わせを指定できます。

値 意味
HDI_BITMAP
 hbm メンバーは有効です。
HDI_DI_SETITEM
 メッセージ HDM_GETITEMの処理中に、ヘッダー コントロールに要求を完了するために必要なすべての値が含まれていない場合があります。 この場合、コントロールは、 HDN_GETDISPINFO 通知を介して値に対してアプリケーションを呼び出す必要があります。 HDI_DI_SETITEMが HDM_GETITEM メッセージに渡された場合、コントロールはHDN_GETDISPINFOから返された値をキャッシュします (それ以外の場合、値は未設定のままです)。
HDI_FORMAT
 fmt メンバーは有効です。
HDI_FILTER
 type メンバーと pvFilter メンバーは有効です。 これは、 型 メンバーで指定された値を除外するために使用されます。
HDI_HEIGHT
 HDI_WIDTHと同じです。
HDI_IMAGE
 iImage メンバーは有効であり、項目と共に表示されるイメージを指定します。
HDI_LPARAM
 lParam メンバーは有効です。
HDI_ORDER
 iOrder メンバーは有効であり、アイテムの注文値を指定します。
HDI_STATE

バージョン 6.00 以降。 状態メンバーは有効です。
HDI_TEXT
 pszText メンバーと cchTextMax メンバーは有効です。
HDI_WIDTH
 cxy メンバーは有効であり、項目の幅を指定します。

cxy

型: int

アイテムの幅または高さ。

pszText

種類: LPTSTR

項目文字列へのポインター。 コントロールからテキストを取得する場合は、このメンバーを初期化して文字バッファーを指す必要があります。 このメンバーが LPSTR_TEXTCALLBACK に設定されている場合、コントロールは HDN_GETDISPINFO通知コード を送信することで、このアイテムのテキスト情報を要求します。 ヘッダー コントロールでは、任意の長さの文字列を項目テキストとして格納できますが、最初の 260 TCHAR のみが表示されることに注意してください。

hbm

種類: HBITMAP

項目ビットマップへのハンドル。

cchTextMax

型: int

項目文字列の長さ (TCHAR単位)。 コントロールからテキストを取得する場合、このメンバーには pszText で指定されたアドレスにある TCHARの数が含まれている必要があります。

fmt

型: int

アイテムの形式を指定するフラグ。

値 意味
テキストの理由:
 テキストの理由を指定するには、次のいずれかのフラグを設定します。
HDF_CENTER
 アイテムの内容が中央に配置されます。
HDF_LEFT
 項目の内容は左揃えです。
HDF_RIGHT
 アイテムの内容は右揃えです。
[Display:]\(表示:\)
 表示を制御するには、次のいずれかのフラグを設定します。
HDF_BITMAP
 項目にビットマップが表示されます。
HDF_BITMAP_ON_RIGHT
 テキストの右側にビットマップが表示されます。
HDF_OWNERDRAW
 ヘッダー コントロールの所有者が項目を描画します。
HDF_STRING
 項目に文字列が表示されます。
フラグの組み合わせ:
 上記の値は、次のように組み合わせることができます。
HDF_IMAGE
 画像リストから画像を表示します。 HDM_SETIMAGELISTメッセージを送信して、画像リスト を 指定します。 この構造体の iImage メンバーでイメージのインデックスを指定します。
HDF_JUSTIFYMASK
 前の表に示した 3 つの理由フラグに対応するビットを分離します。
HDF_RTLREADING
 通常、ウィンドウにはテキストが左から右 (LTR) で表示されます。 Windows は、右から左に読み取るヘブライ語やアラビア語 (RTL) などの言語を表示するために ミラー化 できます。 通常、ヘッダー テキストは親ウィンドウのテキストと同じ方向で読み取られます。 HDF_RTLREADINGが設定されている場合、ヘッダー テキストは親ウィンドウのテキストとは反対の方向に読み取られます。
HDF_SORTDOWN

バージョン 6.00 以降。 この項目に下矢印を描画します。 これは通常、現在のウィンドウの情報がこの列で降順に並べ替えられていることを示すために使用されます。 このフラグをHDF_IMAGEまたはHDF_BITMAPと組み合わせることはできません。
HDF_SORTUP

バージョン 6.00 以降。 このアイテムに上向き矢印を描画します。 これは通常、現在のウィンドウの情報がこの列で昇順で並べ替えられていることを示すために使用されます。 このフラグをHDF_IMAGEまたはHDF_BITMAPと組み合わせることはできません。
HDF_CHECKBOX

バージョン 6.00 以降。 項目にチェックボックスが表示されます。 フラグは、ヘッダー コントロールで HDS_CHECKBOXES スタイルが最初に設定されている場合にのみ有効です。
HDF_CHECKED

バージョン 6.00 以降。 項目にチェック ボックスが表示されます。 フラグは、HDF_CHECKBOXも設定されている場合にのみ有効です。
HDF_FIXEDWIDTH

バージョン 6.00 以降。 アイテムの幅は、ユーザー アクションで変更してサイズを変更することはできません。
HDF_SPLITBUTTON

バージョン 6.00 以降。 項目に分割ボタンが表示されます。 分割ボタンがクリックされると、HDN_DROPDOWN通知が送信されます。

lParam

種類: LPARAM

アプリケーション定義項目データ。

iImage

型: int

イメージ リスト内のイメージの 0 から始まるインデックス。 指定されたイメージは、 hbm フィールドで指定されたイメージに加えて、ヘッダー項目に表示されます。 iImage が I_IMAGECALLBACK に設定されている場合、コントロールはHDN_GETDISPINFO通知コードを使用してこのアイテムのテキスト情報を要求します。 イメージをクリアするには、この値を [I_IMAGENONE] に設定します。

iOrder

型: int

項目がヘッダー コントロール内で左から右に表示される順序。 つまり、左端の項目の値は 0 です。 右側の次の項目の値は 1 などです。

type

型: UINT

pvFilter で指定されたフィルターの種類。 使用できる型は次のとおりです。

値 意味
HDFT_ISSTRING
 文字列データ。
HDFT_ISNUMBER
 数値データ。
HDFT_HASNOVALUE
 pvFilter を無視します。
HDFT_ISDATE

バージョン 6.00 以降。 日付データ。 pvFilter メンバーは、SYSTEMTIME 構造体へのポインターです。

pvFilter

型: void*

アプリケーション定義データ項目のアドレス。 データ フィルターの種類は、メンバーのフラグ値を設定することによって決定されます。 HDFT_ISSTRING フラグを使用して文字列を示し、整数を示HDFT_ISNUMBERします。 HDFT_ISSTRING フラグを使用する場合、 pvFilter は HDTEXTFILTER 構造体へのポインターです。

state

型: UINT

都道府県。 このメンバーに対してサポートされている有効な値は次だけです。

値 意味
HDIS_FOCUSED
 項目にキーボード フォーカスがあります。

注釈

注 Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows に含まれています。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。
 

注意

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして HDITEM を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header commctrl.h