HDITEMW 構造体 (commctrl.h)
ヘッダー コントロール内の項目に関する情報を格納します。 この構造体は 、HD_ITEM 構造体よりも優先されます。
構文
typedef struct _HD_ITEMW {
UINT mask;
int cxy;
LPWSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMW, *LPHDITEMW;
メンバー
mask
型: UINT
有効なデータを含む他の構造体メンバー、または入力する必要がある構造体メンバーを示すフラグ。 このメンバーには、次の値の組み合わせを指定できます。
値 | 意味 |
---|---|
|
hbm メンバーは有効です。 |
|
メッセージ HDM_GETITEMの処理中に、ヘッダー コントロールに要求を完了するために必要なすべての値が含まれていない場合があります。 この場合、コントロールは、 HDN_GETDISPINFO 通知を介してアプリケーションを呼び出して値を返す必要があります。 HDI_DI_SETITEMが HDM_GETITEM メッセージに渡された場合、コントロールはHDN_GETDISPINFOから返された値をすべてキャッシュします (それ以外の場合は、値は未設定のままです)。 |
|
fmt メンバーは有効です。 |
|
type メンバーと pvFilter メンバーは有効です。 これは、 型 メンバーで指定された値をフィルターで除外するために使用されます。 |
|
HDI_WIDTHと同じです。 |
|
iImage メンバーは有効であり、項目と共に表示されるイメージを指定します。 |
|
lParam メンバーは有効です。 |
|
iOrder メンバーは有効であり、アイテムの注文値を指定します。 |
|
バージョン 6.00 以降。 状態メンバーは有効です。 |
|
pszText メンバーと cchTextMax メンバーは有効です。 |
|
cxy メンバーは有効であり、項目の幅を指定します。 |
cxy
型: int
アイテムの幅または高さ。
pszText
種類: LPTSTR
項目文字列へのポインター。 テキストがコントロールから取得される場合、このメンバーは文字バッファーを指すために初期化する必要があります。 このメンバーが LPSTR_TEXTCALLBACK に設定されている場合、コントロールは、 HDN_GETDISPINFO 通知コードを送信することで、このアイテムのテキスト情報を要求します。 ヘッダー コントロールでは、任意の長さの文字列を項目テキストとして格納できますが、最初の 260 TCHAR のみが表示されることに注意してください。
hbm
種類: HBITMAP
項目ビットマップへのハンドル。
cchTextMax
型: int
項目文字列の長さ ( TCHAR単位)。 コントロールからテキストを取得する場合、このメンバーには pszText で指定されたアドレスにある TCHARの数を含む必要があります。
fmt
型: int
アイテムの形式を指定するフラグ。
値 | 意味 |
---|---|
|
次のいずれかのフラグを設定して、テキストの妥当性を指定します。 |
|
アイテムの内容は中央揃えです。 |
|
項目の内容は左揃えです。 |
|
項目の内容は右揃えです。 |
|
表示を制御するには、次のいずれかのフラグを設定します。 |
|
項目にビットマップが表示されます。 |
|
テキストの右側にビットマップが表示されます。 |
|
ヘッダー コントロールの所有者は、項目を描画します。 |
|
項目に文字列が表示されます。 |
|
上記の値は、次のように組み合わせることができます。 |
|
画像リストから画像を表示します。 HDM_SETIMAGELIST メッセージを送信して、イメージ リスト を 指定します。 この構造体の iImage メンバーでイメージのインデックスを指定します。 |
|
前の表に示した 3 つの理由フラグに対応するビットを分離します。 |
|
通常、ウィンドウには左から右 (LTR) のテキストが表示されます。 Windows を ミラーリング して、右から左 (RTL) を読み取るヘブライ語やアラビア語などの言語を表示できます。 通常、ヘッダー テキストは親ウィンドウのテキストと同じ方向で読み取られます。 HDF_RTLREADINGが設定されている場合、ヘッダー テキストは親ウィンドウのテキストとは逆方向に読み取られます。 |
|
バージョン 6.00 以降。 この項目に下矢印を描画します。 これは通常、現在のウィンドウの情報がこの列で降順に並べ替えられていることを示すために使用されます。 このフラグは、HDF_IMAGEまたはHDF_BITMAPと組み合わせることはできません。 |
|
バージョン 6.00 以降。 この項目に上向き矢印を描画します。 これは通常、現在のウィンドウの情報がこの列で昇順で並べ替えられていることを示すために使用されます。 このフラグは、HDF_IMAGEまたはHDF_BITMAPと組み合わせることはできません。 |
|
バージョン 6.00 以降。 項目にチェックボックスが表示されます。 フラグは、 HDS_CHECKBOXES スタイルがヘッダー コントロールで最初に設定されている場合にのみ有効です。 |
|
バージョン 6.00 以降。 項目にチェック ボックスが表示されます。 フラグは、HDF_CHECKBOXも設定されている場合にのみ有効です。 |
|
バージョン 6.00 以降。 アイテムの幅をユーザー アクションで変更してサイズを変更することはできません。 |
|
バージョン 6.00 以降。 項目に分割ボタンが表示されます。 分割ボタンがクリックされると、HDN_DROPDOWN通知が送信されます。 |
lParam
型: LPARAM
アプリケーション定義の項目データ。
iImage
型: int
イメージ リスト内のイメージの 0 から始まるインデックス。 指定されたイメージは、 hbm フィールドで指定されたイメージに加えて、ヘッダー項目に表示されます。 iImage が I_IMAGECALLBACK に設定されている場合、コントロールはHDN_GETDISPINFO通知コードを使用してこのアイテムのテキスト情報を要求します。 イメージをクリアするには、この値を I_IMAGENONE に設定します。
iOrder
型: int
項目がヘッダー コントロール内で左から右に表示される順序。 つまり、左端の項目の値は 0 です。 右側の次の項目の値は 1 です。
type
型: UINT
pvFilter で指定されたフィルターの種類。 使用できる型は次のとおりです。
値 | 意味 |
---|---|
|
文字列データ。 |
|
数値データ。 |
|
pvFilter を無視します。 |
|
バージョン 6.00 以降。 日付データ。 pvFilter メンバーは、SYSTEMTIME 構造体へのポインターです。 |
pvFilter
型: void*
アプリケーション定義データ項目のアドレス。 データ フィルターの種類は、メンバーのフラグ値を設定することによって決定されます。 HDFT_ISSTRING フラグを使用して文字列を示し、整数を示すHDFT_ISNUMBERします。 HDFT_ISSTRING フラグを使用する場合、 pvFilter は HDTEXTFILTER 構造体へのポインターです。
state
型: UINT
都道府県。 このメンバーに対して有効でサポートされている値は次だけです。
値 | 意味 |
---|---|
|
項目にキーボード フォーカスがあります。 |
注釈
注意
commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして HDITEM を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | commctrl.h |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示