Compartir a través de

Estructura COMBOBOXEXITEMA (commctrl.h)

  • Artículo

Contiene información sobre un elemento en 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 de

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 la solicitará de nuevo.
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

Índice de base cero del elemento.

pszText

Tipo: LPTSTR de

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, 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 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 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 equivale 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 de

Valor específico del elemento.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de commctrl.h