TBBUTTON-Struktur (commctrl.h)

Enthält Informationen zu einer Schaltfläche in einer Symbolleiste.

Syntax

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

Member

iBitmap

Typ: int

Nullbasierter Index des Schaltflächenbilds. 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.

Wenn es sich bei der Schaltfläche um ein Trennzeichen handelt, d. h. wenn fsStyle auf BTNS_SEP festgelegt ist, bestimmt iBitmap die Breite des Trennzeichens in Pixel. Informationen zum Auswählen von Schaltflächenbildern aus Bildlisten finden Sie unter TB_SETIMAGELIST Meldung.

idCommand

Typ: int

Befehlsbezeichner, der der Schaltfläche zugeordnet ist. Dieser Bezeichner wird in einer WM_COMMAND Nachricht verwendet, wenn die Schaltfläche ausgewählt wird.

fsState

Typ: BYTE

Schaltflächenstatusflags. Dieser Member kann eine Kombination der Werte sein, die in Symbolleistenschaltflächenzuständen aufgeführt sind.

fsStyle

Typ: BYTE

Schaltflächenformat Bei diesem Element kann es sich um eine Kombination der Werte für die Schaltflächenformatvorlage handeln, die unter Symbolleistensteuerelement und Schaltflächenformatvorlagen aufgeführt sind.

bReserved[6]

Typ: BYTE

Reserviert.

bReserved[2]

Typ: BYTE

Reserviert.

dwData

Typ: DWORD_PTR

Anwendungsdefinierter Wert.

iString

Typ: INT_PTR

Nullbasierter Index der Schaltflächenzeichenfolge oder ein Zeiger auf einen Zeichenfolgenpuffer, der Text für die Schaltfläche enthält.

Hinweise

Das iString-Element kann entweder einen Zeichenfolgenzeiger oder einen Index zurückgeben. Sie können das IS_INTRESOURCE-Makro verwenden, um zu bestimmen, welches zurückgegeben wird.

Anforderungen

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