TB _ GETBUTTONTEXT-Nachricht

Ruft den Anzeigetext einer Schaltfläche auf einer Symbolleiste ab.

Parameter

wParam

Befehlsbezeichner der Schaltfläche, deren Text abgerufen werden soll.

lParam

Zeiger auf einen Puffer, der den Schaltflächentext empfängt.

Rückgabewert

Gibt die Länge der Zeichenfolge in Zeichen zurück, auf die lParam zeigt. Die Länge enthält nicht das beendende NULL-Zeichen. Wenn der Wert nicht erfolgreich ist, ist der Rückgabewert -1.

Bemerkungen

Sicherheitswarnung: Wenn Sie diese Meldung falsch verwenden, kann dies die Sicherheit Ihres Programms gefährden. Diese Meldung bietet Ihnen keine Möglichkeit, die Größe des Puffers zu kennen. Wenn Sie diese Meldung verwenden, rufen Sie zuerst die Meldung auf, die NULL im lParam übergibt. Dadurch wird die Anzahl der zeichen zurückgegeben, mit Ausnahme von NULL, die erforderlich sind. Rufen Sie dann die Nachricht ein zweites Mal auf, um die Zeichenfolge abzurufen. Lesen Sie die Sicherheitsüberlegungen: Microsoft Windows Controls, bevor Sie fortfahren.

Die zurückgegebene Zeichenfolge entspricht dem Text, der derzeit von der Schaltfläche angezeigt wird.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
TB _ GETBUTTONTEXTW (Unicode) und TB _ GETBUTTONTEXTA (ANSI)

Weitere Informationen

Verweis

TB _ GETBUTTONINFO

TB _ GETSTRING

TB _ SETBUTTONINFO