TBN_GETBUTTONINFO Benachrichtigungscode

Ruft Anpassungsinformationen zur Symbolleiste ab und benachrichtigt das übergeordnete Fenster der Symbolleiste über änderungen, die an der Symbolleiste vorgenommen werden. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

TBN_GETBUTTONINFO 

    lpnmtb = (LPNMTOOLBAR) lParam; 

Parameter

lParam

Zeiger auf eine NMTOOLBAR-Struktur . Das iItem-Element gibt einen nullbasierten Index an, der die Anzahl der Schaltflächen bereitstellt, die das Dialogfeld Symbolleiste anpassen auf der Symbolleiste als verfügbar und vorhanden anzeigt. Das pszText-Element gibt die Adresse des aktuellen Schaltflächentexts an, und cchText gibt dessen Länge in Zeichen an. Die Anwendung sollte die Struktur mit Informationen zur Schaltfläche füllen.

Rückgabewert

Gibt TRUE zurück, wenn Schaltflächeninformationen in die angegebene Struktur kopiert wurden, oder andernfalls FALSE .

Bemerkungen

Das Symbolleistensteuerelement weist einen Puffer zu, und der Empfänger (übergeordnetes Fenster) muss den Text in diesen Puffer kopieren. Das cchText-Element enthält die Länge des Puffers, der von der Symbolleiste zugewiesen wird, wenn TBN_GETBUTTONINFO an das übergeordnete Fenster gesendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	TBN_GETBUTTONINFOW (Unicode) und TBN_GETBUTTONINFOA (ANSI)