Freigeben über


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 von lParam verwiesen wird. 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 Nachricht falsch verwenden, kann die Sicherheit Ihres Programms beeinträchtigt werden. Diese Meldung bietet keine Möglichkeit, die Größe des Puffers zu ermitteln. Wenn Sie diese Nachricht verwenden, rufen Sie zuerst die Nachricht auf, die NULL in lParam übergibt. Dies gibt die Anzahl der Zeichen zurück, mit Ausnahme von NULL , die erforderlich sind. Rufen Sie dann die Nachricht ein zweites Mal auf, um die Zeichenfolge abzurufen. Überprüfen Sie die Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente , bevor Sie fortfahren.

Die zurückgegebene Zeichenfolge entspricht dem Text, der derzeit von der Schaltfläche angezeigt 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
TB_GETBUTTONTEXTW (Unicode) und TB_GETBUTTONTEXTA (ANSI)

Weitere Informationen

Referenz

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO