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

pszText 的长度，以 TCHAR为单位。 如果正在设置文本信息，则忽略此成员。

iImage

类型： int

图像列表中图像的从零开始的索引。 未选中项时，将显示指定的图像。 如果此成员设置为 I_IMAGECALLBACK，则控件将使用 CBEN_GETDISPINFO 通知代码请求信息。

iSelectedImage

类型： int

图像列表中图像的从零开始的索引。 当选定项时，将为该项显示指定的图像。 如果此成员设置为 I_IMAGECALLBACK，则控件将使用 CBEN_GETDISPINFO 通知代码请求信息。

iOverlay

类型： int

图像列表中覆盖图像的从 1 开始的索引。 如果此成员设置为 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