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

Класс CMFCRibbonCustomizePropertyPage

  • Статья

Реализует настраиваемую страницу для диалогового окна "Настройка " в приложениях на основе ленты.

Синтаксис

class CMFCRibbonCustomizePropertyPage: public CMFCPropertyPage

Участники

Открытые конструкторы

Имя Описание
CMFCRibbonCustomizePropertyPage::CMFCRibbonCustomizePropertyPage Формирует объект CMFCRibbonCustomizePropertyPage.
CMFCRibbonCustomizePropertyPage::~CMFCRibbonCustomizePropertyPage Деструктор.

Открытые методы

Имя Описание
CMFCRibbonCustomizePropertyPage::AddCustomCategory Добавляет пользовательскую категорию в поле со списком "Команды ".
CMFCRibbonCustomizePropertyPage::CreateObject Используется платформой для создания динамического экземпляра этого типа класса.
CMFCRibbonCustomizePropertyPage::GetThisClass Используется платформой для получения указателя на объект CRuntimeClass , связанный с этим типом класса.
CMFCRibbonCustomizePropertyPage::OnOK Вызывается системой, когда пользователь нажимает кнопку "ОК " в диалоговом окне "Настройка ".

Замечания

Если вы хотите добавить пользовательские команды в диалоговое окно "Настройка ", необходимо обработать сообщение AFX_WM_ON_RIBBON_CUSTOMIZE. В обработчике сообщений создайте CMFCRibbonCustomizePropertyPage экземпляр объекта в стеке. Создайте список настраиваемых команд и вызовите AddCustomCategory новую страницу в диалоговое окно "Настройка ".

Пример

В следующем примере показано, как создать CMFCRibbonCustomizePropertyPage объект и добавить пользовательскую категорию.

// Create "Customize" page
// CMFCRibbonBar m_wndRibbonBar
CMFCRibbonCustomizePropertyPage pageCustomize(&m_wndRibbonBar);

// Create a list of popular items:
CList<UINT, UINT> lstPopular;
lstPopular.AddTail(ID_FILE_NEW);
lstPopular.AddTail(ID_FILE_OPEN);

// add a custom category
pageCustomize.AddCustomCategory(_T("Popular Commands"), lstPopular);

Иерархия наследования

CObject

CCmdTarget

CWnd

CDialog

CPropertyPage

CMFCPropertyPage

CMFCRibbonCustomizePropertyPage

Требования

Заголовок: afxribboncustomizedialog.h

CMFCRibbonCustomizePropertyPage::AddCustomCategory

Добавляет пользовательскую категорию в поле со списком "Команды ".

void AddCustomCategory(
    LPCTSTR lpszName,
    const CList<UINT, UINT>& lstIDS);

Параметры

lpszName
[in] Указывает имя настраиваемой категории.

lstIDS
[in] Содержит идентификаторы команд ленты, отображаемые в пользовательской категории.

Замечания

Этот метод добавляет категорию с именем lpszName в поле со списком Commands . Когда пользователь выбирает категорию, команды, указанные в lstIDS , отображаются в списке команд.

CMFCRibbonCustomizePropertyPage::CMFCRibbonCustomizePropertyPage

Формирует объект CMFCRibbonCustomizePropertyPage.

CMFCRibbonCustomizePropertyPage(CMFCRibbonBar* pRibbonBar = NULL);

Параметры

pRibbonBar
[in] Указатель на элемент управления ленты, для которого необходимо настроить параметры.

CMFCRibbonCustomizePropertyPage::OnOK

Вызываемый системой, когда пользователь нажимает кнопку "ОК " в диалоговом окне "Настройка ".

virtual void OnOK();

Замечания

Реализация по умолчанию применяет параметры, выбранные в диалоговом окне "Настройка " на панели быстрого доступа.

См. также

Диаграмма иерархии
Классы