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

專案以零起始的索引。

pszText

類型：LPTSTR

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

cchTextMax

類型：int

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

要求

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