Classe CMFCRibbonCategory

Artigo
06/10/2015

A classe de CMFCRibbonCategory implementa um guia de fita que contém um grupo de painéis de fita.

class CMFCRibbonCategory : public CObject

Membros

Construtores protegidos

Nome	Descrição
CMFCRibbonCategory::CMFCRibbonCategory	o construtor.

Métodos públicos

Nome	Descrição
CMFCRibbonCategory::AddHidden	Adiciona um elemento oculto na categoria de fita.
CMFCRibbonCategory::AddPanel	Adiciona um painel para a nova categoria de fita.
CMFCRibbonCategory::CopyFrom
CMFCRibbonCategory::FindByData
CMFCRibbonCategory::FindByID
CMFCRibbonCategory::FindPanelWithElem
CMFCRibbonCategory::GetContextID	Retorna a identificação de contexto de categoria de fita.
CMFCRibbonCategory::GetData	Retorna os dados definidos pelo usuário que estão associados com a categoria de fita.
CMFCRibbonCategory::GetDroppedDown
CMFCRibbonCategory::GetElements
CMFCRibbonCategory::GetElementsByID
CMFCRibbonCategory::GetFirstVisibleElement	Obtenha um primeiro elemento visível que pertence à categoria de fita.
CMFCRibbonCategory::GetFocused	Retorna um elemento focalizado.
CMFCRibbonCategory::GetHighlighted	Retorna um elemento realçado.
CMFCRibbonCategory::GetImageCount
CMFCRibbonCategory::GetImageSize
CMFCRibbonCategory::GetItemIDsList
CMFCRibbonCategory::GetLastVisibleElement	Obtenha um elemento visível o último que pertence à categoria de fita
CMFCRibbonCategory::GetLargeImages	Retorna uma referência à lista de grandes imagens que a categoria de fita usa.
CMFCRibbonCategory::GetMaxHeight
CMFCRibbonCategory::GetName
CMFCRibbonCategory::GetPanel	Retorna um ponteiro para o painel de fita que está localizado no índice especificado.
CMFCRibbonCategory::GetPanelCount	Retorna o número de painéis de fita na categoria de fita.
CMFCRibbonCategory::GetPanelFromPoint
CMFCRibbonCategory::GetPanelIndex	Retorna o índice especificado do painel de fita.
CMFCRibbonCategory::GetParentButton
CMFCRibbonCategory::GetParentMenuBar
CMFCRibbonCategory::GetParentRibbonBar
CMFCRibbonCategory::GetRect
CMFCRibbonCategory::GetSmallImages	Retorna uma referência à lista de imagens pequenas que a categoria usa.
CMFCRibbonCategory::GetTabColor	Retorna a cor atual da guia da categoria de fita.
CMFCRibbonCategory::GetTabRect
CMFCRibbonCategory::GetTextTopLine
CMFCRibbonCategory::GetVisibleElements	Obter todos os elementos visíveis que pertencem a categoria de fita.
CMFCRibbonCategory::HighlightPanel
CMFCRibbonCategory::HitTest
CMFCRibbonCategory::HitTestEx
CMFCRibbonCategory::HitTestScrollButtons
CMFCRibbonCategory::IsActive
CMFCRibbonCategory::IsVisible	Determina se a categoria de fita é visível.
CMFCRibbonCategory::IsWindows7Look	Indica se a fita pai tiver o aspecto de estilo Windows 7 (botão pequena retangular do aplicativo)
CMFCRibbonCategory::NotifyControlCommand
CMFCRibbonCategory::OnCancelMode
CMFCRibbonCategory::OnDraw
CMFCRibbonCategory::OnDrawImage
CMFCRibbonCategory::OnDrawMenuBorder
CMFCRibbonCategory::OnKey	Chamado pela estrutura quando um usuário pressiona um botão do teclado.
CMFCRibbonCategory::OnLButtonDown
CMFCRibbonCategory::OnLButtonUp
CMFCRibbonCategory::OnMouseMove
CMFCRibbonCategory::OnRTLChanged
CMFCRibbonCategory::OnScrollHorz
CMFCRibbonCategory::OnUpdateCmdUI
CMFCRibbonCategory::RecalcLayout
CMFCRibbonCategory::RemovePanel
CMFCRibbonCategory::ReposPanels
CMFCRibbonCategory::SetCollapseOrder	Define a ordem de recolher painéis de fita presentes na categoria de fita.
CMFCRibbonCategory::SetData	Armazena os dados definidos pelo usuário na categoria de fita.
CMFCRibbonCategory::SetKeys	Atribui um keytip a categoria de fita.
CMFCRibbonCategory::SetName
CMFCRibbonCategory::SetTabColor	Define a cor de categoria de fita.

Comentários

Normalmente, você cria uma categoria de fita indiretamente chamando CMFCRibbonBar::AddCategory, que retorna um ponteiro para a categoria recém-criado de fita. Você adiciona os painéis a categoria chamando CMFCRibbonCategory::AddPanel.

A classe de CMFCRibbonTab desenha categorias de fita. é derivada de Classe CMFCRibbonBaseElement.

Este exemplo a seguir demonstra como criar uma categoria de fita e adicionar um painel.

// 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

O diagrama a seguir mostra uma figura de categoria do início do aplicativo de exemplo RibbonApp.