Struttura COMBOBOXEXITEMW (commctrl.h)

  • Articolo

Contiene informazioni su un elemento in un controllo ComboBoxEx.

Sintassi

typedef struct tagCOMBOBOXEXITEMW {
  UINT    mask;
  INT_PTR iItem;
  LPWSTR  pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMW, *PCOMBOBOXEXITEMW;

Members

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
 Imposta questo flag durante l'elaborazione CBEN_GETDISPINFO; Il controllo ComboBoxEx manterrà 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 le informazioni di testo vengono recuperate, 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 è selezionata. Se questo membro è impostato su I_IMAGECALLBACK, il controllo richiederà le informazioni usando CBEN_GETDISPINFO codici di notifica.

iOverlay

Tipo: int

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

Requisiti

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