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;

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