Structure COMBOBOXEXITEMW (commctrl.h)

Contient des informations sur un élément dans un contrôle ComboBoxEx.

Syntaxe

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

Membres

mask

Type : UINT

Ensemble d’indicateurs de bits qui spécifient les attributs de cette structure ou d’une opération qui utilise cette structure. Les indicateurs spécifient les membres qui sont valides ou doivent être renseignés. Ce membre peut être une combinaison des valeurs suivantes.

Valeur	Signification
CBEIF_DI_SETITEM	Définissez cet indicateur lors du traitement des CBEN_GETDISPINFO ; Le contrôle ComboBoxEx conserve les informations fournies et ne les demande pas à nouveau.
CBEIF_IMAGE	Le membre iImage est valide ou doit être renseigné.
CBEIF_INDENT	Le membre iIndent est valide ou doit être renseigné.
CBEIF_LPARAM	Le membre lParam est valide ou doit être renseigné.
CBEIF_OVERLAY	Le membre iOverlay est valide ou doit être renseigné.
CBEIF_SELECTEDIMAGE	Le membre iSelectedImage est valide ou doit être renseigné.
CBEIF_TEXT	Le membre pszText est valide ou doit être renseigné.

iItem

Type : INT_PTR

Index de base zéro de l'élément.

pszText

Type : LPTSTR

Pointeur vers une mémoire tampon de caractères qui contient ou reçoit le texte de l’élément. Si des informations de texte sont récupérées, ce membre doit être défini sur l’adresse d’une mémoire tampon de caractères qui recevra le texte. La taille de cette mémoire tampon doit également être indiquée dans cchTextMax. Si ce membre est défini sur LPSTR_TEXTCALLBACK, le contrôle demande les informations à l’aide des codes de notification CBEN_GETDISPINFO .

cchTextMax

Type : int

Longueur de pszText, en TCHAR. Si des informations de texte sont définies, ce membre est ignoré.

iImage

Type : int

Index de base zéro d’une image dans la liste d’images. L’image spécifiée s’affiche pour l’élément lorsqu’il n’est pas sélectionné. Si ce membre est défini sur I_IMAGECALLBACK, le contrôle demande les informations à l’aide de CBEN_GETDISPINFO codes de notification.

iSelectedImage

Type : int

Index de base zéro d’une image dans la liste d’images. L’image spécifiée s’affiche pour l’élément lorsqu’il est sélectionné. Si ce membre est défini sur I_IMAGECALLBACK, le contrôle demande les informations à l’aide de CBEN_GETDISPINFO codes de notification.

iOverlay

Type : int

Index de base un d’une image superposée dans la liste d’images. Si ce membre est défini sur I_IMAGECALLBACK, le contrôle demande les informations à l’aide de CBEN_GETDISPINFO codes de notification.

iIndent

Type : int

Nombre d’espaces de retrait à afficher pour l’élément. Chaque retrait est égal à 10 pixels. Si ce membre est défini sur I_INDENTCALLBACK, le contrôle demande les informations à l’aide de CBEN_GETDISPINFO codes de notification.

lParam

Type : LPARAM

Valeur spécifique à l’élément.

Remarques

Notes

L’en-tête commctrl.h définit COMBOBOXEXITEM comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h