Struttura COMBOBOXEXITEMA (commctrl.h)

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;

Membri

mask

Tipo: UINT

Set di flag di bit che specificano gli attributi di questa struttura o di un'operazione che utilizza questa struttura. I flag specificano i membri validi o che 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 manterrà le informazioni fornite e non la 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 dell'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 utilizzando i codici di notifica CBEN_GETDISPINFO.

cchTextMax

Tipo: int

Lunghezza di pszText, in TCHAR. 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 utilizzando 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 è selezionata. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni utilizzando CBEN_GETDISPINFO codici di notifica.

iOverlay

Tipo: int

Indice in base uno di un'immagine di sovrimpressione all'interno dell'elenco di immagini. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni utilizzando 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 utilizzando CBEN_GETDISPINFO codici di notifica.

lParam

Tipo: LPARAM

Valore specifico dell'elemento.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	commctrl.h