macro TabCtrl_GetItem (commctrl.h)

Récupère des informations sur un onglet dans un contrôle tabulation. Vous pouvez utiliser cette macro ou envoyer explicitement le message TCM_GETITEM.

Syntaxe

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle Tab.

iItem

Type : int

Index de l’onglet.

pitem

Type : LPTCITEM

Pointeur vers une structure TCITEM qui spécifie les informations à récupérer et recevoir des informations sur l’onglet. Lorsque le message est envoyé, le masque masque membre spécifie les attributs à retourner. Si le masque membre spécifie la valeur TCIF_TEXT, le membre pszText doit contenir l’adresse de la mémoire tampon qui reçoit le texte de l’élément, et le membre cchTextMax doit spécifier la taille de la mémoire tampon.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Si l’indicateur TCIF_TEXT est défini dans le masque membre de la structure TCITEM, le contrôle peut modifier le membre pszText de la structure pour pointer vers le nouveau texte au lieu de remplir la mémoire tampon avec le texte demandé. Le contrôle peut définir le membre pszText sur NULL pour indiquer qu’aucun texte n’est associé à l’élément.

Exigences