Поделиться через


CMFCToolBarsCustomizeDialog::AddButton

Вставляет кнопку панели инструментов в список команд на странице Команды.

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

Параметры

  • [входящий] uiCategoryId
    Указывает идентификатор категории, в которую вставляется кнопку.

  • [входящий] button
    Указывает кнопку для вставки.

  • [входящий] iInsertBefore
    Определяет нулевой- основан индекс кнопки панели инструментов, перед которой кнопку вставить.

  • [входящий] lpszCategory
    Указывает строку категории для вставки кнопку.

Заметки

Метод AddButton игнорирует кнопки, имеющих стандартные идентификаторы команд (например ID_FILE_MRU_FILE1) команды, которые не разрешены (см. CMFCToolBar::IsCommandPermitted) и фиктивные кнопки.

Этот метод создает новый объект того же типа, что button (обычно Класс CMFCToolBarButton) с помощью класса среды выполнения кнопки. Затем он вызывает CMFCToolBarButton::CopyFrom для копирования элементов данных кнопки и вставляет копию в указанную категорию.

При вставке новой кнопки, принимающий уведомление о OnAddToCustomizePage.

Если iInsertBefore -1, то кнопка добавлена в список категорий; в противном случае она вставляется перед элементом с заданным индексом.

Пример

В следующем примере показано, как использовать метод AddButton класса CMFCToolBarsCustomizeDialog. Этот фрагмент кода является частью Образец slider.

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

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

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

Требования

заголовок: afxToolBarsCustomizeDialog.h

См. также

Ссылки

Класс CMFCToolBarsCustomizeDialog

Диаграмма иерархии