Freigeben über


CMFCToolBarsCustomizeDialog::AddButton

Fügt eine Symbolleisten-Schaltfläche in die Liste von Befehlen auf der Seite Befehle ein.

void AddButton(
   UINT uiCategoryId,
   const CMFCToolBarButton& button,
   int iInsertBefore=-1 
);
void AddButton(
   LPCTSTR lpszCategory,
   const CMFCToolBarButton& button,
   int iInsertBefore=-1 
);

Parameter

  • [in] uiCategoryId
    Gibt die Kategorie-ID an, in die die Schaltfläche einfügen.

  • [in] button
    Gibt die Schaltfläche, um einzufügen.

  • [in] iInsertBefore
    Gibt den nullbasierten Index einer Symbolleistenschaltfläche an, die vor der Schaltfläche eingefügt wird.

  • [in] lpszCategory
    Gibt die Kategorienzeichenfolge an, um die Schaltfläche einzufügen.

Hinweise

Die Methode ignoriert AddButton Schaltflächen, die die Standardbefehl IDs verfügen (z ID_FILE_MRU_FILE1), Befehle, die nicht (siehe CMFCToolBar::IsCommandPermitted) und blinde Schaltflächen zulässig sind.

Diese Methode erstellt ein neues Objekt desselben Typs wie button (normalerweise CMFCToolBarButton-Klasse) durch die Laufzeitklasse der Schaltfläche verwendet. Sie ruft dann CMFCToolBarButton::CopyFrom auf, um die Datenmember der Schaltfläche zu kopieren und die Kopie in die angegebene Kategorie ein.

Wenn die neue Schaltfläche eingefügt, erhält sie die OnAddToCustomizePage Benachrichtigung.

Wenn iInsertBefore -1 ist, wird die Schaltfläche zur Liste der Kategorien angefügt; andernfalls wird sie vor dem Element mit dem angegebenen Index eingefügt.

Beispiel

Das folgende Beispiel zeigt, wie die Methode der Klasse AddButtonCMFCToolBarsCustomizeDialog verwendet. Dieser Codeausschnitt ist Teil Slider-Beispiel.

    CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
        TRUE /* Automatic menus scaning */);

    CSliderButton btnSlider (ID_SLIDER);
    btnSlider.SetRange (0, 100);

    pDlgCust->AddButton (_T("Edit"), btnSlider);

Anforderungen

Header: afxToolBarsCustomizeDialog.h

Siehe auch

Referenz

CMFCToolBarsCustomizeDialog-Klasse

Hierarchiediagramm