Класс CMFCRibbonSeparator

Реализует разделитель ленты.

Синтаксис

class CMFCRibbonSeparator : public CMFCRibbonBaseElement

Участники

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

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

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

Имя	Описание
CMFCRibbonSeparator::AddToListBox	Добавляет разделитель в список команд в диалоговом окне "Настройка ". (Переопределения CMFCRibbonBaseElement::AddToListBox.)
CMFCRibbonSeparator::CreateObject	Используется платформой для создания динамического экземпляра этого типа класса.
CMFCRibbonSeparator::GetThisClass	Используется платформой для получения указателя на объект CRuntimeClass , связанный с этим типом класса.

Защищенные методы

Имя	Описание
CMFCRibbonSeparator::CopyFrom	Метод копирования, который задает переменные-члены разделителя из другого объекта.
CMFCRibbonSeparator::GetRegularSize	Возвращает размер разделителя.
CMFCRibbonSeparator::IsSeparator	Указывает, является ли это разделителем.
CMFCRibbonSeparator::IsTabStop	Указывает, является ли это остановкой табуляции.
CMFCRibbonSeparator::OnDraw	Вызывается системой для рисования разделителя на ленте или панели быстрого доступа.
CMFCRibbonSeparator::OnDrawOnList	Вызывается системой для рисования разделителя в списке команд .

Замечания

Разделитель ленты — это вертикальная или горизонтальная линия, которая логически отделяет элементы ленты. Разделитель можно нарисовать на элементе управления лентой, главном меню приложения, строке состояния ленты и панели быстрого доступа.

Чтобы использовать разделитель в приложении, создайте новый объект и добавьте его в главное меню приложения, как показано ниже:

CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
    IDB_FILESMALL,
    IDB_FILELARGE);

...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

Вызовите CMFCRibbonPanel::AddSeparator , чтобы добавить разделители на панели ленты. Разделители выделяются и добавляются внутри AddSeparator метода.

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

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

Требования

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

CMFCRibbonSeparator::AddToListBox

Добавляет разделитель в список команд в диалоговом окне "Настройка ".

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Параметры

pWndListBox
[in] Указатель на список команд , в котором добавляется разделитель.

bDeep
[in] Игнорировать.

Возвращаемое значение

Отсчитываемый от нуля индекс в строке списка, указанной pWndListBox.

CMFCRibbonSeparator::CMFCRibbonSeparator

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

CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);

Параметры

bIsHoriz
[in] Если значение TRUE, разделитель является горизонтальным; Значение false, разделитель вертикали.

Замечания

Горизонтальные разделители используются в меню приложения. Вертикальные разделители используются на панелях инструментов.

Пример

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

// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

CMFCRibbonSeparator::CopyFrom

Метод копирования, который задает переменные-члены разделителя из другого объекта.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Параметры

Src
[in] Исходный элемент ленты для копирования.

CMFCRibbonSeparator::GetRegularSize

Возвращает размер разделителя.

virtual CSize GetRegularSize(CDC* pDC);

Параметры

pDC
[in] Указатель на содержимое устройства.

Возвращаемое значение

Размер разделителя в заданном контексте устройства.

CMFCRibbonSeparator::IsSeparator

Указывает, является ли это разделителем.

virtual BOOL IsSeparator() const;

Возвращаемое значение

Always TRUE для этого класса.

CMFCRibbonSeparator::IsTabStop

Указывает, является ли это остановкой табуляции.

virtual BOOL IsTabStop() const;

Возвращаемое значение

Всегда FALSE для этого класса.

Замечания

Разделитель ленты не является остановкой табуляции.

CMFCRibbonSeparator::OnDraw

Вызывается системой для рисования разделителя на ленте или панели быстрого доступа.

virtual void OnDraw(CDC* pDC);

Параметры

pDC
[in] Указатель на контекст устройства.

CMFCRibbonSeparator::OnDrawOnList

Вызывается системой для рисования разделителя в списке команд .

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Параметры

pDC
[in] Указатель на контекст устройства.

strText
[in] Текст, отображаемый в списке.

nTextOffset
[in] Интервал между текстом и левой стороной ограничивающего прямоугольника.

rect
[in] Задает ограничивающий прямоугольник.

bIsSelected
[in] Игнорировать.

bHighlighted
[in] Игнорировать.

См. также

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