Класс 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 метода.
Иерархия наследования
Требования
Заголовок: 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] Игнорировать.