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

Структура 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 в TCHARs. Если задана текстовая информация, этот элемент игнорируется.

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