次の方法で共有

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 通知を介して値に対してアプリケーションを呼び出す必要があります。 HDM_GETITEM メッセージでHDI_DI_SETITEMが渡された場合、コントロールはHDN_GETDISPINFOから返された値をキャッシュします (それ以外の場合、値は未設定のままです)。
HDI_FORMAT
 fmt メンバーは有効です。
HDI_FILTER
 型の と 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
 項目の内容は右揃えです。
表示:
 表示を制御するには、次のいずれかのフラグを設定します。
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します。 pvFilter HDFT_ISSTRING フラグを使用する場合は、HDTEXTFILTER 構造体へのポインターです。

state

型: UINT

状態。 このメンバーでサポートされている有効な値は次だけです。

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

備考

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

手記

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

必要条件

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