TB_GETBUTTONINFO Nachricht

Ruft erweiterte Informationen für eine Schaltfläche in einer Symbolleiste ab.

Parameter

wParam

Befehlsbezeichner der Schaltfläche.

lParam

Zeiger auf eine TBBUTTONINFO-Struktur , die die Schaltflächeninformationen empfängt. Die elemente cbSize und dwMask dieser Struktur müssen vor dem Senden dieser Nachricht ausgefüllt werden.

Rückgabewert

Gibt den nullbasierten Index der Schaltfläche oder -1 zurück, wenn ein Fehler auftritt.

Bemerkungen

Wenn Sie TB_ADDBUTTONS oder TB_INSERTBUTTON verwenden, um Schaltflächen auf der Symbolleiste zu platzieren, wird der Schaltflächentext häufig durch den Zeichenfolgenpoolindex angegeben. TB_GETBUTTONINFO ruft diese Zeichenfolge nicht ab. Um TB_GETBUTTONINFO zum Abrufen von Schaltflächentext zu verwenden, müssen Sie zuerst die Textzeichenfolge mit TB_SETBUTTONINFO festlegen. Nachdem Sie den Schaltflächentext mit TB_SETBUTTONINFO festgelegt haben, können Sie den Zeichenfolgenpoolindex nicht mehr verwenden.

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	TB_GETBUTTONINFOW (Unicode) und TB_GETBUTTONINFOA (ANSI)

Weitere Informationen

Referenz

TB_SETBUTTONINFO

TB_GETBUTTONTEXT