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_GETITEMet 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 de 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 les 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 tabulation valides, consultez États d’élément de contrôle tabulation. Ce membre est ignoré dans le message TCM_INSERTITEM.

dwStateMask

Type : DWORD

version 4.70. Spécifie les bits du membre dwState contenant 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 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 dans s 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

Index dans la liste d’images du contrôle tabulation 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 Tab. Si plusieurs ou moins de 4 octets de données définies par application existent par onglet, une application doit définir une structure et l’utiliser au lieu 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 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 TCITEM 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