Structure TCITEMHEADERA (commctrl.h)

  • Article

Spécifie ou reçoit les attributs d’un onglet. Il est utilisé avec les messages TCM_INSERTITEM, TCM_GETITEM et 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 vers pszText s’affiche dans le sens opposé au texte dans la fenêtre parente.
TCIF_TEXT
 Le membre pszText est valide.

lpReserved1

Type : UINT

Membre réservé. Ne pas utiliser.

lpReserved2

Type : UINT

Membre réservé. Ne pas utiliser.

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 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 de la mémoire tampon pointée vers 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.

Notes

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 TCITEMHEADER 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.

Spécifications

   
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