Freigeben über


BCM_GETNOTE Nachricht

Ruft den Text der Notiz ab, die einer Befehlslinkschaltfläche zugeordnet ist. Sie können diese Nachricht explizit senden oder das makro Button_GetNote verwenden.

Parameter

wParam [ein, aus]

Ein DWORD , das die Größe des Puffers angibt, auf den lParam in Zeichen verweist.

lParam [out]

Der Zeichenfolgenpuffer, um den Text zu empfangen. Der Puffer muss groß genug sein, um das beendende NULL-Zeichen aufzunehmen.

Rückgabewert

Wenn die Nachricht erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Bemerkungen

Die BCM_GETNOTE Nachricht funktioniert nur mit Schaltflächen, die das BS_COMMANDLINK- oder BS_DEFCOMMANDLINK-Schaltflächenformat aufweisen.

GetLastError enthält Folgendes:

  • ERROR_NOT_SUPPORTED, wenn die Schaltfläche nicht über das BS_DEFCOMMANDLINK - oder BS_COMMANDLINK-Format verfügt.
  • ERROR_INSUFFICIENT_BUFFER, wenn der lParam-Puffer zu klein ist. Der wParam-Parameter enthält die erforderliche Puffergröße in Zeichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Commctrl.h

Siehe auch

Referenz

Schaltflächenstile

Konzept

Schaltflächentypen