TBBUTTONINFOA-Struktur (commctrl.h)

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;

Angehörige

cbSize

Typ: UINT-

Größe der Struktur in Byte. Dieses Mitglied muss vor dem Senden der zugeordneten Nachricht ausgefüllt werden.

dwMask

Typ: DWORD-

Satz von Flags, die angeben, welche Member gültige Informationen enthalten. Dieses Mitglied muss vor dem Senden der zugeordneten Nachricht ausgefüllt werden. Dabei kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
TBIF_BYINDEX	Version 5.80. Die wParam-, die mit einer TB_GETBUTTONINFO oder TB_SETBUTTONINFO Nachricht gesendet wurde, ist ein Index, kein Bezeichner.
TBIF_COMMAND	Das idCommand- Mitglied enthält gültige Informationen oder wird angefordert.
TBIF_IMAGE	Das iImage Mitglied enthält gültige Informationen oder wird angefordert.
TBIF_LPARAM	Das lParam- Mitglied enthält gültige Informationen oder wird angefordert.
TBIF_SIZE	Das cx Mitglied enthält gültige Informationen oder wird angefordert.
TBIF_STATE	Das fsState Mitglied enthält gültige Informationen oder wird angefordert.
TBIF_STYLE	Der fsStyle Member enthält gültige Informationen oder wird angefordert.
TBIF_TEXT	Das pszText Mitglied 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-

Statuskennzeichnungen der Schaltfläche. Dies kann ein oder mehrere der Werte sein, die in Symbolleistenschaltflächenstatusaufgeführt sind.

fsStyle

Typ: BYTE-

Formatvorlagenkennzeichnungen der Schaltfläche. Dies kann ein oder mehrere der Werte sein, die in Symbolleisten-Steuerelement- und Schaltflächenformatvorlagenaufgefü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 dieses Element ignoriert.

Bemerkungen

Anmerkung

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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	commctrl.h