Partager via


code de notification TBN_GETBUTTONINFO

Récupère les informations de personnalisation de la barre d’outils et avertit la fenêtre parente de la barre d’outils des modifications apportées à la barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .

TBN_GETBUTTONINFO 

    lpnmtb = (LPNMTOOLBAR) lParam; 

Paramètres

lParam

Pointeur vers une structure NMTOOLBAR . Le membre iItem spécifie un index de base zéro qui fournit le nombre des boutons que la boîte de dialogue Personnaliser la barre d’outils affiche comme disponibles et présents dans la barre d’outils. Le membre pszText spécifie l’adresse du texte du bouton actif, et cchText spécifie sa longueur en caractères. L’application doit remplir la structure avec des informations sur le bouton.

Valeur retournée

Retourne TRUE si les informations de bouton ont été copiées dans la structure spécifiée, ou FALSE dans le cas contraire.

Notes

Le contrôle de barre d’outils alloue une mémoire tampon, et le récepteur (fenêtre parente) doit copier le texte dans cette mémoire tampon. Le membre cchText contient la longueur de la mémoire tampon allouée par la barre d’outils lorsque TBN_GETBUTTONINFO est envoyé à la fenêtre parente.

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
TBN_GETBUTTONINFOW (Unicode) et TBN_GETBUTTONINFOA (ANSI)