Compartir a través de


Estructura COMBOBOXEXITEMW (commctrl.h)

Contiene información sobre un elemento de un control ComboBoxEx.

Sintaxis

typedef struct tagCOMBOBOXEXITEMW {
  UINT    mask;
  INT_PTR iItem;
  LPWSTR  pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMW, *PCOMBOBOXEXITEMW;

Miembros

mask

Tipo: UINT

Conjunto de marcas de bits que especifican atributos de esta estructura o de una operación que usa esta estructura. Las marcas especifican miembros que son válidos o deben rellenarse. Este miembro puede ser una combinación de los valores siguientes.

Valor Significado
CBEIF_DI_SETITEM
Establezca esta marca al procesar CBEN_GETDISPINFO; El control ComboBoxEx conservará la información proporcionada y no la volverá a solicitar.
CBEIF_IMAGE
El miembro iImage es válido o debe rellenarse.
CBEIF_INDENT
El miembro iIndent es válido o debe rellenarse.
CBEIF_LPARAM
El miembro lParam es válido o debe rellenarse.
CBEIF_OVERLAY
El miembro iOverlay es válido o debe rellenarse.
CBEIF_SELECTEDIMAGE
El miembro iSelectedImage es válido o debe rellenarse.
CBEIF_TEXT
El miembro pszText es válido o debe rellenarse.

iItem

Tipo: INT_PTR

El índice de base cero de un elemento.

pszText

Tipo: LPTSTR

Puntero a un búfer de caracteres que contiene o recibe el texto del elemento. Si se recupera información de texto, este miembro debe establecerse en la dirección de un búfer de caracteres que recibirá el texto. El tamaño de este búfer también debe indicarse en cchTextMax. Si este miembro se establece en LPSTR_TEXTCALLBACK, el control solicitará la información mediante los códigos de notificación CBEN_GETDISPINFO .

cchTextMax

Tipo: int

Longitud de pszText, en TCHARs. Si se establece información de texto, se omite este miembro.

iImage

Tipo: int

Índice de base cero de una imagen dentro de la lista de imágenes. La imagen especificada se mostrará para el elemento cuando no esté seleccionada. Si este miembro se establece en I_IMAGECALLBACK, el control solicitará la información mediante CBEN_GETDISPINFO códigos de notificación.

iSelectedImage

Tipo: int

Índice de base cero de una imagen dentro de la lista de imágenes. La imagen especificada se mostrará para el elemento cuando se seleccione. Si este miembro se establece en I_IMAGECALLBACK, el control solicitará la información mediante CBEN_GETDISPINFO códigos de notificación.

iOverlay

Tipo: int

Índice basado en una imagen de superposición dentro de la lista de imágenes. Si este miembro se establece en I_IMAGECALLBACK, el control solicitará la información mediante CBEN_GETDISPINFO códigos de notificación.

iIndent

Tipo: int

Número de espacios de sangría que se van a mostrar para el elemento. Cada sangría es igual a 10 píxeles. Si este miembro se establece en I_INDENTCALLBACK, el control solicitará la información mediante CBEN_GETDISPINFO códigos de notificación.

lParam

Tipo: LPARAM

Valor específico del elemento.

Comentarios

Nota

El encabezado commctrl.h define COMBOBOXEXITEM como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h