Structure TCITEMW (commctrl.h)

Spécifie ou reçoit les attributs d’un élément d’onglet. Il est utilisé avec les messages TCM_INSERTITEM, TCM_GETITEM et TCM_SETITEM . Cette structure remplace la structure TC_ITEM .

Syntaxe

typedef struct tagTCITEMW {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMW, *LPTCITEMW;

Membres

mask

Type : UINT

Valeur qui spécifie les membres à récupérer ou à définir. Ce membre peut être une combinaison des valeurs suivantes :

Valeur	Signification
TCIF_IMAGE	Le membre iImage est valide.
TCIF_PARAM	Le membre lParam est valide.
TCIF_RTLREADING	La chaîne pointée vers pszText s’affiche dans le sens opposé au texte dans la fenêtre parente.
TCIF_STATE	Version 4.70. Le membre dwState est valide.
TCIF_TEXT	Le membre pszText est valide.

dwState

Type : DWORD

Version 4.70. Spécifie l’état actuel de l’élément si des informations sont récupérées. Si les informations d’élément sont définies, ce membre contient la valeur d’état à définir pour l’élément. Pour obtenir la liste des états d’élément de contrôle d’onglet valides, consultez Tab Control Item States. Ce membre est ignoré dans le message TCM_INSERTITEM .

dwStateMask

Type : DWORD

Version 4.70. Spécifie les bits du membre dwState qui contiennent des informations valides. Ce membre est ignoré dans le message TCM_INSERTITEM .

pszText

Type : LPTSTR

Pointeur vers une chaîne terminée par null qui contient le texte de l’onglet lorsque les informations d’élément sont définies. Si les informations d’élément sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte de l’onglet.

cchTextMax

Type : int

Taille dans TCHARs de la mémoire tampon pointée par le membre pszText . Si la structure ne reçoit pas d’informations, ce membre est ignoré.

iImage

Type : int

Indexez dans la liste d’images du contrôle tabulation ou -1 s’il n’existe aucune image pour l’onglet.

lParam

Type : LPARAM

Données définies par l’application associées à l’élément de contrôle tabulation. Si plus ou moins de 4 octets de données définies par l’application existent par onglet, une application doit définir une structure et l’utiliser à la place de la structure TCITEM . Le premier membre de la structure définie par l’application doit être une structure TCITEMHEADER .

En règle générale, les fenêtres affichent du texte de gauche à droite (LTR). Windows peut être mis en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). Normalement, pszText s’affiche dans la même direction que le texte dans sa fenêtre parente. Si TCIF_RTLREADING est défini, pszText lit dans le sens inverse du texte dans la fenêtre parente.

Notes

L’en-tête commctrl.h définit TCITEM comme un 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. Le mélange 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