Partager via


TB_GETBUTTONTEXT message

Récupère le texte d’affichage d’un bouton dans une barre d’outils.

Paramètres

wParam

Identificateur de commande du bouton dont le texte doit être récupéré.

lParam

Pointeur vers une mémoire tampon qui reçoit le texte du bouton.

Valeur retournée

Retourne la longueur, en caractères, de la chaîne pointée par lParam. La longueur n’inclut pas le caractère null de fin. En cas d’échec, la valeur de retour est -1.

Notes

Avertissement de sécurité : L’utilisation incorrecte de ce message peut compromettre la sécurité de votre programme. Ce message ne vous permet pas de connaître la taille de la mémoire tampon. Si vous utilisez ce message, appelez d’abord le message en passant la valeur NULL dans l’élément lParam, ce qui renvoie le nombre de caractères, à l’exclusion de la valeur NULL requise. Appelez ensuite le message une deuxième fois pour récupérer la chaîne. Vous devez passer en revue les considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.

La chaîne retournée correspond au texte actuellement affiché par le bouton.

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
TB_GETBUTTONTEXTW (Unicode) et TB_GETBUTTONTEXTA (ANSI)

Voir aussi

Référence

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO