通过

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