Structure TCITEMA (commctrl.h)

  • Article

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 tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

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 par pszText s’affiche dans la direction opposée 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 des informations sur l’é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 tabulation lorsque les informations d’élément sont définies. Si des informations sur l’é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 en TCHARde 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 d’onglet ou -1 s’il n’y a pas d’image pour l’onglet.

lParam

Type : LPARAM

Données définies par l’application associées à l’élément de contrôle tabulation. S’il existe plus ou moins de 4 octets de données définies par l’application 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 .

Remarques

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). En règle générale, 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 la direction opposée du texte de 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. 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