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 |
|
| Unicode- und ANSI-Name |
TB _ GETBUTTONTEXTW (Unicode) und TB _ GETBUTTONTEXTA (ANSI) |