Класс CMFCRibbonCategory

Статья
06/10/2015

Класс CMFCRibbonCategory реализует вкладке ленты, содержащую группу в составе область ленты.

class CMFCRibbonCategory : public CObject

Члены

Защищенные конструкторы

Имя	Описание
CMFCRibbonCategory::CMFCRibbonCategory	Конструктор.

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

Имя	Описание
CMFCRibbonCategory::AddHidden	Добавляет скрытый элемент к категории ленты.
CMFCRibbonCategory::AddPanel	Добавляет новую область в категории ленты.
CMFCRibbonCategory::CopyFrom
CMFCRibbonCategory::FindByData
CMFCRibbonCategory::FindByID
CMFCRibbonCategory::FindPanelWithElem
CMFCRibbonCategory::GetContextID	Получает контекстный идентификатор категории ленты.
CMFCRibbonCategory::GetData	Возвращает определяемые пользователем данные, которые сопоставлены с категорией ленты.
CMFCRibbonCategory::GetDroppedDown
CMFCRibbonCategory::GetElements
CMFCRibbonCategory::GetElementsByID
CMFCRibbonCategory::GetFirstVisibleElement	Получает первый видимый элемент, который принадлежит к категории ленты.
CMFCRibbonCategory::GetFocused	Возвращает элемент с фокусом.
CMFCRibbonCategory::GetHighlighted	Возвращает выбранный элемент.
CMFCRibbonCategory::GetImageCount
CMFCRibbonCategory::GetImageSize
CMFCRibbonCategory::GetItemIDsList
CMFCRibbonCategory::GetLastVisibleElement	Получает последний элемент visible, принадлежит к категории ленты
CMFCRibbonCategory::GetLargeImages	Возвращает ссылку на список больших изображений, категория ленты.
CMFCRibbonCategory::GetMaxHeight
CMFCRibbonCategory::GetName
CMFCRibbonCategory::GetPanel	Возвращает указатель на панели ленты, найдено по указанному индексу.
CMFCRibbonCategory::GetPanelCount	Возвращает количество областей ленты в категории ленты.
CMFCRibbonCategory::GetPanelFromPoint
CMFCRibbonCategory::GetPanelIndex	Возвращает индекс указанной панели ленты.
CMFCRibbonCategory::GetParentButton
CMFCRibbonCategory::GetParentMenuBar
CMFCRibbonCategory::GetParentRibbonBar
CMFCRibbonCategory::GetRect
CMFCRibbonCategory::GetSmallImages	Возвращает ссылку на список небольших изображений, категория используется.
CMFCRibbonCategory::GetTabColor	Возвращает текущий цвет вкладки " категории ленты.
CMFCRibbonCategory::GetTabRect
CMFCRibbonCategory::GetTextTopLine
CMFCRibbonCategory::GetVisibleElements	Получает все видимые элементы, принадлежащие категории " на ленте.
CMFCRibbonCategory::HighlightPanel
CMFCRibbonCategory::HitTest
CMFCRibbonCategory::HitTestEx
CMFCRibbonCategory::HitTestScrollButtons
CMFCRibbonCategory::IsActive
CMFCRibbonCategory::IsVisible	Указывает, видима ли категория " на ленте.
CMFCRibbonCategory::IsWindows7Look	Указывает, имеет ли выбрать родительский элемент лента стиля Windows 7 (небольшую прямоугольную кнопку приложения)
CMFCRibbonCategory::NotifyControlCommand
CMFCRibbonCategory::OnCancelMode
CMFCRibbonCategory::OnDraw
CMFCRibbonCategory::OnDrawImage
CMFCRibbonCategory::OnDrawMenuBorder
CMFCRibbonCategory::OnKey	Вызываемый платформой, когда пользователь отожмет кнопку клавиатуры.
CMFCRibbonCategory::OnLButtonDown
CMFCRibbonCategory::OnLButtonUp
CMFCRibbonCategory::OnMouseMove
CMFCRibbonCategory::OnRTLChanged
CMFCRibbonCategory::OnScrollHorz
CMFCRibbonCategory::OnUpdateCmdUI
CMFCRibbonCategory::RecalcLayout
CMFCRibbonCategory::RemovePanel
CMFCRibbonCategory::ReposPanels
CMFCRibbonCategory::SetCollapseOrder	Определяет порядок свернуть области ленты, которые присутствуют в категории ленты.
CMFCRibbonCategory::SetData	Хранит определяемые пользователем данные в категории ленты.
CMFCRibbonCategory::SetKeys	Присвоит keytip к категории ленты.
CMFCRibbonCategory::SetName
CMFCRibbonCategory::SetTabColor	Устанавливает цвет категории ленты.

Заметки

Обычно создается категория ленты косвенно путем вызова CMFCRibbonBar::AddCategory, который возвращает указатель на вновь созданной категории ленты. Добавление панелей в категории путем вызова CMFCRibbonCategory::AddPanel.

Класс CMFCRibbonTab рисует категории ленты. Он является производным от Класс CMFCRibbonBaseElement.

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

// Create a new ribbon category and get a pointer to it

CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory

(_T("&Write"), // Category name

IDB_WRITE, // Category small images (16 x 16)

IDB_WRITE_LARGE); // Category large images (32 x 32)

// Add a panel to the new category

CMFCRibbonPanel* pPanel = pCategory->AddPanel (

_T("Clipboard"), // Panel name

m_PanelIcons.ExtractIcon (0)); // Panel icon

На следующей диаграмме показана диаграмма домашней категории из примера приложения RibbonApp.