Partager via

TCITEMHEADERA, structure (commctrl.h)

  • Article

Spécifie ou reçoit les attributs d’un onglet. Il est utilisé avec les messages TCM_INSERTITEM, TCM_GETITEMet TCM_SETITEM. Cette structure remplace la structure TC_ITEMHEADER.

Syntaxe

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

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_RTLREADING
 La chaîne pointée par pszText s’affiche dans la direction opposée au texte de la fenêtre parente.
TCIF_TEXT
 Le membre pszText est valide.

lpReserved1

Type : UINT

Membre réservé. N’utilisez pas.

lpReserved2

Type : UINT

Membre réservé. N’utilisez pas.

pszText

Type : LPTSTR

Adresse d’une chaîne terminée par null qui contient le texte de l’onglet si 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 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 la liste d’images du contrôle Tab ou -1 s’il n’y a pas d’image pour l’onglet.

Remarques

En règle générale, les fenêtres affichent du texte de gauche à droite (LTR). Windows peut être mise 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éfinie, pszText lit dans la direction opposée du texte dans la fenêtre parente.

Note

L’en-tête commctrl.h définit TCITEMHEADER 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. 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête commctrl.h