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

項目之以零起始的索引。

pszText

類型： LPTSTR

包含或接收專案文字之字元緩衝區的指標。 如果要擷取文字資訊，此成員必須設定為將接收文字之字元緩衝區的位址。 此緩衝區的大小也必須以 cchTextMax 表示。 如果這個成員設定為LPSTR_TEXTCALLBACK，控件會使用 CBEN_GETDISPINFO 通知碼來要求資訊。

cchTextMax

類型： int

TCHARs 中 pszText 的長度。 如果設定文字資訊，則會忽略這個成員。

iImage

類型： int

影像清單中的影像以零起始的索引。 未選取專案時，將會顯示指定的影像。 如果此成員設定為I_IMAGECALLBACK，控件會使用 CBEN_GETDISPINFO 通知碼來要求資訊。

iSelectedImage

類型： int

影像清單中的影像以零起始的索引。 選取專案時，將會顯示指定的影像。 如果此成員設定為I_IMAGECALLBACK，控件會使用 CBEN_GETDISPINFO 通知碼來要求資訊。

iOverlay

類型： int

影像清單中重疊影像的單一型索引。 如果此成員設定為I_IMAGECALLBACK，控件會使用 CBEN_GETDISPINFO 通知碼來要求資訊。

iIndent

類型： int

要針對項目顯示的縮排空格數目。 每個縮排等於10圖元。 如果此成員設定為I_INDENTCALLBACK，控件會使用 CBEN_GETDISPINFO 通知碼來要求資訊。

lParam

類型： LPARAM

專案特定的值。

備註

注意

commctrl.h 標頭會將 COMBOBOXEXITEM 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	commctrl.h