TCM_GETITEM message

Récupère des informations sur un onglet dans un contrôle d’onglet. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TabCtrl_GetItem .

Paramètres

wParam

Index de l’onglet.

lParam

Pointeur vers une structure TCITEM qui spécifie les informations à récupérer et reçoit des informations sur l’onglet. Lorsque le message est envoyé, le membre du masque spécifie les attributs à retourner. Si le membre mask 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 retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

Notes

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

Spécifications

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
Noms Unicode et ANSI	TCM_GETITEMW (Unicode) et TCM_GETITEMA (ANSI)