Поделиться через

Структура 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

Одноуровневый индекс изображения наложения в списке изображений. Если для этого элемента задано значение I_IMAGECALLBACK, элемент управления запрашивает информацию с помощью кодов уведомлений CBEN_GETDISPINFO.

iIndent

Тип: int

Количество отступов, отображаемых для элемента. Каждая отступа равна 10 пикселям. Если для этого элемента задано значение I_INDENTCALLBACK, элемент управления запрашивает информацию с помощью кодов уведомлений CBEN_GETDISPINFO.

lParam

Тип: LPARAM

Значение, относящееся к элементу.

Замечания

Заметка

Заголовок commctrl.h определяет COMBOBOXEXITEM как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка commctrl.h