CToolBar::SetButtonInfo

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.

Informationen zum Bitmapbilder und Schaltflächen, finden Sie die CToolBar Übersicht und CToolBar::LoadBitmap.

Anforderungen

Header: afxext.h

Siehe auch

Referenz

CToolBar-Klasse

Hierarchien-Diagramm

CToolBar::GetButtonInfo