CToolBar::SetButtonInfo

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um die Befehls-ID Schaltfläche, das Format und die Imagezahl festzulegen.

void SetButtonInfo(
   int nIndex,
   UINT nID,
   UINT nStyle,
   int iImage 
);

Parameter

nIndex
Der nullbasierte Index der Schaltfläche oder des Trennzeichens, für die Informationen festgelegt werden sollen.
nID
Der Wert, der die Befehls-ID der Schaltfläche festgelegt wird.
nStyle
Das neue Schaltflächenformat.Die folgenden Schaltflächenformate werden unterstützt:
- TBBS_BUTTON Standardpushbutton (Standard)
- TBBS_SEPARATOR Trennzeichen
- Automatische Kontrollkästchenschaltfläche TBBS_CHECKBOX
- TBBS_GROUP kennzeichnet den Anfang einer Gruppe Schaltflächen
- TBBS_CHECKGROUP kennzeichnet den Anfang einer Gruppe Kontrollkästchenschaltflächen
- TBBS_DROPDOWN stellt eine Dropdownlistenschaltfläche erstellt.
- TBBS_AUTOSIZE die Breite der Schaltfläche wird auf dem Text der Schaltfläche, nicht auf die Größe des Bilds abgeleitet.
- TBBS_NOPREFIX der Anmeldung keine Zugriffstastenpräfix, das zugeordnet ist.
iImage
Neuer Index für das Bild der Schaltfläche innerhalb der Bitmaps.

Hinweise

Für die Trennzeichen das Format TBBS_SEPARATOR haben, gibt diese Funktion, die die Breite des Trennzeichens in Pixel auf den Wert in iImage gespeichert ist.

Hinweis
Sie können die Schaltflächenzustände festlegen, die den nStyle-Parameter verwenden; da jedoch Schaltflächenzustände vom ON_UPDATE_COMMAND_UI-Handler gesteuert werden, geben Sie alle festgelegt mithilfe SetButtonInfo verloren während der nächsten Leerlaufverarbeitung an.Siehe Wie Benutzeroberflächenobjekte aktualisiert und TN031: Steuerleisten weitere Informationen.