TBBUTTONINFOA-Struktur (commctrl.h)

  • Artikel

Enthält Oder empfängt Informationen für eine bestimmte Schaltfläche in einer Symbolleiste.

Syntax

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

Member

cbSize

Typ: UINT

Größe der Struktur in Bytes. Dieser Member muss vor dem Senden der zugehörigen Nachricht ausgefüllt werden.

dwMask

Typ: DWORD

Eine Reihe von Flags, die angeben, welche Member gültige Informationen enthalten. Dieser Member muss vor dem Senden der zugehörigen Nachricht ausgefüllt werden. Dies kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
TBIF_BYINDEX

Version 5.80. Die wParam , die mit einer TB_GETBUTTONINFO - oder TB_SETBUTTONINFO-Nachricht gesendet wird, ist ein Index, kein Bezeichner.
TBIF_COMMAND
 Das idCommand-Element enthält gültige Informationen oder wird angefordert.
TBIF_IMAGE
 Das iImage-Element enthält gültige Informationen oder wird angefordert.
TBIF_LPARAM
 Das lParam-Element enthält gültige Informationen oder wird angefordert.
TBIF_SIZE
 Das cx-Element enthält gültige Informationen oder wird angefordert.
TBIF_STATE
 Das fsState-Element enthält gültige Informationen oder wird angefordert.
TBIF_STYLE
 Das fsStyle-Element enthält gültige Informationen oder wird angefordert.
TBIF_TEXT
 Das pszText-Element enthält gültige Informationen oder wird angefordert.

idCommand

Typ: int

Befehlsbezeichner der Schaltfläche.

iImage

Typ: int

Bildindex der Schaltfläche. Legen Sie dieses Element auf I_IMAGECALLBACK fest, und die Symbolleiste sendet den TBN_GETDISPINFO Benachrichtigungscode, um den Bildindex abzurufen, wenn er benötigt wird.

Version 5.81. Legen Sie dieses Element auf I_IMAGENONE fest, um anzugeben, dass die Schaltfläche kein Bild enthält. Das Schaltflächenlayout enthält keinen Platz für eine Bitmap, nur Text.

fsState

Typ: BYTE

Statusflags der Schaltfläche. Dies kann mindestens einer der Werte sein, die in Symbolleistenschaltflächenzuständen aufgeführt sind.

fsStyle

Typ: BYTE

Formatflags der Schaltfläche. Dies kann mindestens einer der Werte sein, die unter Symbolleistensteuerelement und Schaltflächenformatvorlagen aufgeführt sind.

cx

Typ: WORD

Breite der Schaltfläche in Pixel.

lParam

Typ: DWORD_PTR

Anwendungsdefinierter Wert, der der Schaltfläche zugeordnet ist.

pszText

Typ: LPTSTR

Adresse eines Zeichenpuffers, der den Schaltflächentext enthält oder empfängt.

cchText

Typ: int

Größe des Puffers bei pszText. Wenn die Schaltflächeninformationen festgelegt werden, wird dieser Member ignoriert.

Hinweise

Hinweis

Der commctrl.h-Header definiert TBBUTTONINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h