COMBOBOXEXITEMW 構造体 (commctrl.h)

  • [アーティクル]

ComboBoxEx コントロール内の項目に関する情報を格納します。

構文

typedef struct tagCOMBOBOXEXITEMW {
  UINT    mask;
  INT_PTR iItem;
  LPWSTR  pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMW, *PCOMBOBOXEXITEMW;

メンバー

mask

型: UINT

この構造体の属性、またはこの構造体を使用する操作の属性を指定するビット フラグのセット。 フラグは、有効なメンバー、または入力する必要があるメンバーを指定します。 このメンバーには、次の値の組み合わせを指定できます。

値 意味
CBEIF_DI_SETITEM
 CBEN_GETDISPINFOの処理時にこのフラグを設定します。ComboBoxEx コントロールは、指定された情報を保持し、再び要求しません。
CBEIF_IMAGE
 iImage メンバーは有効であるか、入力する必要があります。
CBEIF_INDENT
 iIndent メンバーは有効であるか、入力する必要があります。
CBEIF_LPARAM
 lParam メンバーは有効であるか、入力する必要があります。
CBEIF_OVERLAY
 iOverlay メンバーは有効であるか、入力する必要があります。
CBEIF_SELECTEDIMAGE
 iSelectedImage メンバーは有効であるか、入力する必要があります。
CBEIF_TEXT
 pszText メンバーは有効であるか、入力する必要があります。

iItem

種類: INT_PTR

項目の 0 から始まるインデックス。

pszText

種類: LPTSTR

アイテムのテキストを格納または受信する文字バッファーへのポインター。 テキスト情報を取得する場合、このメンバーはテキストを受け取る文字バッファーのアドレスに設定する必要があります。 このバッファーのサイズは cchTextMax でも指定する必要があります。 このメンバーが LPSTR_TEXTCALLBACK に設定されている場合、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。

cchTextMax

型: int

pszText の長さ (TCHAR単位)。 テキスト情報が設定されている場合、このメンバーは無視されます。

iImage

型: int

イメージ リスト内のイメージの 0 から始まるインデックス。 選択されていない場合は、指定した画像がアイテムに対して表示されます。 このメンバーが I_IMAGECALLBACK に設定されている場合、コントロールはCBEN_GETDISPINFO通知コードを使用して情報 を 要求します。

iSelectedImage

型: int

イメージ リスト内のイメージの 0 から始まるインデックス。 アイテムが選択されると、指定した画像が表示されます。 このメンバーが I_IMAGECALLBACK に設定されている場合、コントロールはCBEN_GETDISPINFO通知コードを使用して情報 を 要求します。

iOverlay

型: int

イメージ リスト内のオーバーレイ イメージの 1 から始まるインデックス。 このメンバーが I_IMAGECALLBACK に設定されている場合、コントロールはCBEN_GETDISPINFO通知コードを使用して情報 を 要求します。

iIndent

型: int

アイテムに表示するインデントスペースの数。 各インデントは 10 ピクセルです。 このメンバーが I_INDENTCALLBACK に設定されている場合、コントロールはCBEN_GETDISPINFO通知コードを使用して情報 を 要求します。

lParam

種類: LPARAM

アイテムに固有の値。

注釈

注意

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

要件

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