Compartir a través de

Estructura COMBOBOXEXITEMA (commctrl.h)

  • Artículo

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

Sintaxis

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

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 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 volverá a solicitarla.
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 de CBEN_GETDISPINFO .

cchTextMax

Tipo: int

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

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 está establecido 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 está establecido en I_IMAGECALLBACK, el control solicitará la información mediante CBEN_GETDISPINFO códigos de notificación.

iOverlay

Tipo: int

Índice basado en uno de una imagen de superposición dentro de la lista de imágenes. Si este miembro está establecido 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 está establecido 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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