Condividi tramite

Struttura COMBOBOXEXITEMA (commctrl.h)

  • Articolo

Contiene informazioni su un elemento in un controllo ComboBoxEx.

Sintassi

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

Members

mask

Tipo: UINT

Set di flag di bit che specificano attributi di questa struttura o di un'operazione che usa questa struttura. I flag specificano i membri validi o devono essere compilati. Questo membro può essere una combinazione dei valori seguenti.

Valore Significato
CBEIF_DI_SETITEM
 Impostare questo flag durante l'elaborazione CBEN_GETDISPINFO; il controllo ComboBoxEx mantiene le informazioni fornite e non lo richiederà di nuovo.
CBEIF_IMAGE
 Il membro iImage è valido o deve essere compilato.
CBEIF_INDENT
 Il membro iIndent è valido o deve essere compilato.
CBEIF_LPARAM
 Il membro lParam è valido o deve essere compilato.
CBEIF_OVERLAY
 Il membro iOverlay è valido o deve essere compilato.
CBEIF_SELECTEDIMAGE
 Il membro iSelectedImage è valido o deve essere compilato.
CBEIF_TEXT
 Il membro pszText è valido o deve essere compilato.

iItem

Tipo: INT_PTR

Indice in base zero di un elemento.

pszText

Tipo: LPTSTR

Puntatore a un buffer di caratteri che contiene o riceve il testo dell'elemento. Se vengono recuperate informazioni di testo, questo membro deve essere impostato sull'indirizzo di un buffer di caratteri che riceverà il testo. Le dimensioni di questo buffer devono essere indicate anche in cchTextMax. Se questo membro è impostato su LPSTR_TEXTCALLBACK, il controllo richiederà le informazioni usando i codici di notifica CBEN_GETDISPINFO .

cchTextMax

Tipo: int

Lunghezza di pszText, in TCHARs. Se vengono impostate informazioni di testo, questo membro viene ignorato.

iImage

Tipo: int

Indice in base zero di un'immagine all'interno dell'elenco di immagini. L'immagine specificata verrà visualizzata per l'elemento quando non è selezionata. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni usando CBEN_GETDISPINFO codici di notifica.

iSelectedImage

Tipo: int

Indice in base zero di un'immagine all'interno dell'elenco di immagini. L'immagine specificata verrà visualizzata per l'elemento quando viene selezionato. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni usando CBEN_GETDISPINFO codici di notifica.

iOverlay

Tipo: int

Indice basato su un'immagine di sovrapposizione all'interno dell'elenco di immagini. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni usando CBEN_GETDISPINFO codici di notifica.

iIndent

Tipo: int

Numero di spazi di rientro da visualizzare per l'elemento. Ogni rientro è uguale a 10 pixel. Se questo membro è impostato su I_INDENTCALLBACK, il controllo richiederà le informazioni usando CBEN_GETDISPINFO codici di notifica.

lParam

Tipo: LPARAM

Valore specifico dell'elemento.

Commenti

Nota

L'intestazione commctrl.h definisce COMBOBOXEXITEM come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h