COMBOBOXEXITEMA 構造体 (commctrl.h)

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

構文

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

メンバー

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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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