`CMFCRibbonBar` Classe

Artigo
03/17/2025

A classe CMFCRibbonBar implementa uma barra de faixa de opções semelhante à usada no Office 2007.

Para obter mais detalhes, consulte o código-fonte localizado na pasta mfc da instalação do Visual Studio. Por exemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaxe

class CMFCRibbonBar : public CPane

Membros

Construtores Públicos

Designação	Descrição
`CMFCRibbonBar::CMFCRibbonBar`	Construtor padrão.

Métodos Públicos

Designação	Descrição
`CMFCRibbonBar::ActivateContextCategory`	Ativa uma categoria de contexto que já está visível.
`CMFCRibbonBar::AddCategory`	Adiciona uma nova categoria de faixa de opções à faixa de opções.
`CMFCRibbonBar::AddContextCategory`	Adiciona uma categoria de contexto.
`CMFCRibbonBar::AddMainCategory`	Adiciona uma nova categoria de faixa de opções principal.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Adicione um elemento da faixa de opções ao lado direito de uma barra da faixa de opções.
`CMFCRibbonBar::CreateEx`	Cria uma barra de controle e a anexa ao objeto `CPane`. (Substitui `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Cria um controle de barra de faixa de opções e o anexa a uma barra de faixa de opções.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Habilite ou desabilite as dicas de teclas para o controle da faixa de opções.
`CMFCRibbonBar::EnablePrintPreview`	Habilite a guia Visualização de Impressão.
`CMFCRibbonBar::EnableToolTips`	Habilita ou desabilita dicas de ferramentas e descrições de dicas de ferramentas na barra da faixa de opções.
`CMFCRibbonBar::FindByData`	Localize um elemento da faixa de opções usando dados especificados por um usuário.
`CMFCRibbonBar::FindByID`	Localiza um elemento da faixa de opções que tem a ID de comando especificada.
`CMFCRibbonBar::FindCategoryIndexByData`	Localiza o índice da categoria da faixa de opções que contém os dados definidos pelo usuário.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Obtém um ponteiro para uma categoria ativa.
`CMFCRibbonBar::GetCaptionHeight`	Retorna a altura da legenda. (Substitui `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Obtém o ponteiro para uma categoria localizada em um índice especificado.
`CMFCRibbonBar::GetCategoryCount`	Obtém o número das categorias da faixa de opções na barra da faixa de opções.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Retorna o índice de uma categoria da faixa de opções.
`CMFCRibbonBar::GetContextName`	Recupera o nome da legenda da categoria de contexto que você especifica usando uma ID.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Obtém uma matriz que contém os ponteiros para todos os elementos da faixa de opções que têm a ID especificada.
`CMFCRibbonBar::GetApplicationButton`	Obtém um ponteiro para um botão da faixa de opções.
`CMFCRibbonBar::GetFocused`	Retorna um elemento focado.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Retorna um ponteiro para a categoria da faixa de opções selecionada no momento.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Preenche uma lista que contém as IDs de comando de todos os elementos que aparecem na Barra de Ferramentas de Acesso Rápido.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Oculta todas as categorias que estão ativas e visíveis.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Localiza um ponteiro para o elemento da faixa de opções localizado no ponto especificado nas coordenadas do cliente da barra da faixa de opções.
`CMFCRibbonBar::IsKeyTipEnabled`	Determina se as dicas de teclas estão habilitadas.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Determina se a guia Visualização de Impressão está habilitada.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Especifica se a Barra de Ferramentas de Acesso Rápido está localizada acima da barra da faixa de opções.
`CMFCRibbonBar::IsReplaceFrameCaption`	Determina se a barra da faixa de opções substitui a legenda do quadro principal ou se é adicionada abaixo da legenda do quadro.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Determina se as descrições da dica de ferramenta estão habilitadas.
`CMFCRibbonBar::IsToolTipEnabled`	Determina se as dicas de ferramentas para a barra da faixa de opções estão habilitadas.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Indica se a faixa de opções tem aparência no estilo do Windows 7 (pequeno botão de aplicativo retangular).
`CMFCRibbonBar::LoadFromResource`	Sobrecarregado. Carrega uma Barra de Faixa de Opções a partir de recursos do aplicativo.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Substitui `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Substitui `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Substitui `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Substitui `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Remove todas as categorias do friso da barra do friso.
`CMFCRibbonBar::RemoveAllFromTabs`	Remove todos os elementos da faixa de opções da área da guia.
`CMFCRibbonBar::RemoveCategory`	Remove a categoria da faixa de opções localizada no índice especificado.
`CMFCRibbonBar::SaveToXMLBuffer`	Salva a Barra da Faixa de Opções em um buffer.
`CMFCRibbonBar::SaveToXMLFile`	Salva a Barra da Faixa de Opções no arquivo XML.
`CMFCRibbonBar::SetActiveCategory`	Define uma categoria de faixa de opções especificada como ativa.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Define as dicas de teclas especificadas para todos os elementos da faixa de opções que têm a ID de comando especificada.
`CMFCRibbonBar::SetApplicationButton`	Atribui um botão da faixa de opções do aplicativo à barra da faixa de opções.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Adiciona um ou mais elementos da faixa de opções à Barra de Ferramentas de Acesso Rápido.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Especifica o estado padrão da Barra de Ferramentas de Acesso Rápido.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Posiciona a Barra de Ferramentas de Acesso Rápido (QAT) acima ou abaixo da barra da faixa de opções.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Ativar/desativar a faixa de opções Aparência no estilo do Windows 7 (pequeno botão de aplicativo retangular)
`CMFCRibbonBar::ShowCategory`	Mostra ou oculta a categoria de faixa de opções especificada.
`CMFCRibbonBar::ShowContextCategories`	Mostra ou oculta as categorias de contexto que têm a ID especificada.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Alterna a barra da faixa de opções entre os estados minimizado e maximizado.
`CMFCRibbonBar::TranslateChar`

Comentários

A Microsoft introduziu a Faixa de Opções do Office Fluent quando lançou simultaneamente o Microsoft Office 2007. Esta barra de faixa de opções não é apenas um novo controle. Representa um novo paradigma de interface de utilizador. A faixa de opções é um painel que contém um conjunto de guias chamadas categorias. Cada categoria é logicamente dividida em painéis de faixa de opções e cada painel pode conter vários controles e botões de comando.

Os elementos que aparecem na barra do friso expandem-se e contraem-se para tirar o melhor partido do espaço disponível. Por exemplo, se um painel da faixa de opções não tiver espaço suficiente para exibir seus elementos, ele se tornará um botão de menu que exibe subitens em um menu pop-up. A barra de fita se comporta como uma barra de controle estática (não flutuante) e pode ser encaixada na parte superior de um quadro.

Você pode usar a classe CMFCRibbonStatusBar para implementar uma barra de status semelhante à usada no Office 2007. Uma categoria de faixa de opções contém (e exibe) um grupo de painéis de faixa de opções . Cada painel da faixa de opções contém um ou mais elementos da faixa de opções, que são derivados de CMFCRibbonBaseElement.

Para obter informações sobre como adicionar uma barra de faixa de opções ao seu aplicativo MFC existente, consulte Passo a passo: Atualizando o aplicativo MFC Scribble.

Hierarquia de herança

Requerimentos

Cabeçalho:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Ativa uma categoria de contexto que já está visível.

BOOL ActivateContextCategory(UINT uiContextID);

Parâmetros

uiContextID
[em] O ID da categoria de contexto.

Valor de retorno

TRUE se uma categoria de contexto com uiContextID for encontrada e ativada; caso contrário, FALSE.

`CMFCRibbonBar::AddCategory`

Cria e inicializa uma nova categoria de faixa de opções para a barra da faixa de opções.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parâmetros

lpszName
[em] Nome da categoria da faixa de opções.

uiSmallImagesResID
[em] ID do recurso da pequena lista de imagens para a categoria do friso.

uiLargeImagesResID
[em] ID do recurso da lista de imagens grande para a categoria da faixa de opções.

sizeSmallImage
[em] Especifica o tamanho de imagens pequenas para a categoria da faixa de opções.

sizeLargeImage
[em] Especifica o tamanho das imagens grandes para a categoria da faixa de opções.

nInsertAt
[em] Índice baseado em zero da localização da categoria.

pRTI
[em] Ponteiro para uma classe CMFCRibbonCategory classe de tempo de execução para criar dinamicamente uma categoria de faixa de opções em tempo de execução.

Valor de retorno

Um ponteiro para a nova categoria da faixa de opções se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

Se o parâmetro pRTI não estiver NULL, a nova categoria da faixa de opções será criada dinamicamente usando a classe de tempo de execução.

Exemplo

O exemplo a seguir demonstra como usar o método AddCategory na classe CMFCRibbonBar.

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Cria e inicializa uma nova categoria de contexto para a barra da faixa de opções.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parâmetros

lpszName
[em] Nome da categoria.

lpszContextName
[em] Nome da legenda da categoria de contexto.

uiContextID
[em] ID de contexto.

clrContext
[em] Cor da legenda da categoria de contexto.

uiSmallImagesResID
[em] ID de recurso da imagem pequena de uma categoria de contexto.

uiLargeImagesResID
[em] ID de recurso da imagem grande de uma categoria de contexto.

sizeSmallImage
[em] Tamanho de uma imagem pequena.

sizeLargeImage
[em] Tamanho de uma imagem grande.

pRTI
[em] Ponteiro para uma classe de tempo de execução.

Valor de retorno

Um ponteiro para a categoria recém-criada, ou NULL se o método CreateObject de pRTI não puder criar a categoria especificada.

Comentários

Use esta função para adicionar uma categoria de contexto. As categorias de contexto são um tipo especial de categoria que pode ser mostrada ou ocultada em tempo de execução, dependendo do contexto atual do aplicativo. Por exemplo, quando o usuário seleciona um objeto, você pode exibir guias especiais com categorias de contexto, que você usa para alterar o objeto selecionado específico.

A cor de uma categoria de contexto pode ser um dos seguintes valores:

AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet

`CMFCRibbonBar::AddMainCategory`

Cria uma nova categoria de faixa de opções principal para a barra da faixa de opções.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parâmetros

lpszName
[em] Nome da categoria principal da faixa de opções.

uiSmallImagesResID
[em] ID de recurso de imagens pequenas.

uiLargeImagesResID
[em] ID do recurso de imagens grandes.

sizeSmallImage
[em] O tamanho de imagens pequenas.

sizeLargeImage
[em] O tamanho de imagens grandes.

Valor de retorno

Ponteiro para a nova categoria da faixa de opções principal se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

Se já existir uma categoria principal do friso, esta é eliminada.

Exemplo

O exemplo a seguir demonstra como usar o método AddMainCategory na classe CMFCRibbonBar.

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Cria uma categoria de visualização de impressão na barra da faixa de opções.

CMFCRibbonCategory* AddPrintPreviewCategory();

Valor de retorno

Um ponteiro para a nova categoria da faixa de opções se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

Esse método cria uma categoria de faixa de opções e os controles necessários para fornecer uma visualização de impressão.

`CMFCRibbonBar::AddQATOnlyCategory`

Cria uma categoria de faixa de opções da barra de ferramentas de acesso rápido.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parâmetros

lpszName
[em] Nome da categoria.

uiSmallImagesResID
[em] ID do recurso da lista de imagens para a categoria.

sizeSmallImage
[em] Tamanho das imagens para elementos da faixa de opções na categoria.

Valor de retorno

Um ponteiro para a nova categoria se o método foi bem-sucedido; caso contrário, NULL.

Comentários

A categoria da faixa de opções da barra de ferramentas de acesso rápido só é usada na caixa de diálogo de personalização da barra de ferramentas de acesso rápido.

`CMFCRibbonBar::AddToTabs`

Adiciona o elemento da faixa de opções especificado à linha de guias da barra da faixa de opções.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parâmetros

pElement
[em] Ponteiro para um elemento da faixa de opções.

Comentários

O elemento da faixa de opções é posicionado antes de qualquer botão do sistema.

`CMFCRibbonBar::CMFCRibbonBar`

Constrói e inicializa um objeto CMFCRibbonBar.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parâmetros

bReplaceFrameCaption
[em] TRUE para a barra da faixa de opções substituir a legenda da janela do quadro principal; FALSE localizar a barra da faixa de opções sob a legenda da janela do quadro principal.

Comentários

`CMFCRibbonBar::Create`

Cria uma janela para a barra da faixa de opções.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parâmetros

pParentWnd
[em] Ponteiro para a janela pai da barra da faixa de opções.

dwStyle
[em] Uma combinação lógica de estilos para a nova janela.

nID
[em] ID da nova janela.

Valor de retorno

TRUE se a janela foi criada; caso contrário, FALSE.

Comentários

Exemplo

O exemplo a seguir demonstra como usar o método Create da classe CMFCRibbonBar.

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Cria uma janela para a barra da faixa de opções.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parâmetros

pParentWnd
[em] Ponteiro para a janela pai da barra da faixa de opções.

dwCtrlStyle
[em] Este parâmetro não é usado.

dwStyle
[em] Uma combinação lógica de estilos para a nova janela.

nID
[em] ID da nova janela.

Valor de retorno

TRUE se a janela foi criada; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::DeactivateKeyboardFocus`

Fecha todos os controles de dica de tecla na barra da faixa de opções.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parâmetros

bSetFocus
[in] TRUE definir o foco para a janela pai da barra da faixa de opções.

Comentários

`CMFCRibbonBar::DrawMenuImage`

Desenha a imagem para um botão de menu.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parâmetros

pDC
[em] Ponteiro para um contexto de dispositivo para o botão de menu.

pMenuItem
[em] Ponteiro para um botão de menu da barra de ferramentas.

rectImage
[em] O retângulo de exibição para um botão de menu.

Valor de retorno

TRUE se a imagem foi desenhada; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::DWMCompositionChanged`

Ajusta a exibição da barra da faixa de opções quando a composição do DWM (Desktop Window Manager) está habilitada ou desabilitada.

virtual void DWMCompositionChanged();

Comentários

`CMFCRibbonBar::EnableKeyTips`

Habilita ou desabilita o recurso de dica de tecla para a barra da faixa de opções.

void EnableKeyTips(BOOL bEnable = TRUE);

Parâmetros

bEnable
[em] TRUE para ativar o recurso de dicas de teclas; FALSE desativar o recurso de dicas de teclas.

Comentários

Quando você habilita esse recurso, as dicas de teclas são exibidas quando o usuário pressiona as teclas ALT ou F10. Quando o usuário pressiona tecla ALT, as dicas de teclas são exibidas com um atraso de 200 milissegundos. Esse atraso permite que atalhos sejam executados para que a tecla ALT pressionada não interfira com outras combinações que incluem a tecla ALT.

`CMFCRibbonBar::EnablePrintPreview`

Ativa ou desativa o recurso de visualização de impressão.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parâmetros

bEnable
[em] TRUE para ativar o recurso Print Preview; FALSE desativar o recurso Visualização de Impressão.

Comentários

Se bEnable estiver FALSE e existir uma categoria de visualização de impressão, ela será excluída.

Por predefinição, a funcionalidade Pré-visualização de Impressão está ativada.

`CMFCRibbonBar::EnableToolTips`

Habilita ou desabilita dicas de ferramentas e descrições de dicas de ferramentas opcionais na barra da faixa de opções.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parâmetros

bEnable
[em] TRUE para ativar dicas de ferramentas na barra da faixa de opções; FALSE desativar as dicas de ferramentas na barra da faixa de opções.

bEnableDescr
[in] TRUE para habilitar descrições de dica de ferramenta na dica de ferramenta; FALSE desativar as descrições da dica de ferramenta na dica de ferramenta.

Comentários

O parâmetro bEnable determina se as dicas de ferramentas são exibidas quando o mouse passa sobre um elemento da faixa de opções. O parâmetro bEnableDescr determina se o texto descritivo adicional aparece com o texto da dica de ferramenta.

`CMFCRibbonBar::FindByData`

Recupera um ponteiro para um elemento da faixa de opções se ele tiver os dados e a visibilidade especificados.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parâmetros

dwData
[em] Os dados associados a um elemento da faixa de opções.

bVisibleOnly
[em] TRUE pesquisar apenas elementos visíveis da faixa de opções; FALSE pesquisar todos os elementos da faixa de opções.

Valor de retorno

Um ponteiro para um elemento da faixa de opções se ele tiver os dados especificados e a visibilidade; caso contrário, NULL.

Comentários

Um elemento da faixa de opções é qualquer controle que você pode adicionar à faixa de opções, como um botão da faixa de opções, uma categoria da faixa de opções ou um controle deslizante da faixa de opções.

`CMFCRibbonBar::FindByID`

Recupera um ponteiro para o elemento da faixa de opções que tem a ID de comando especificada e os valores de pesquisa.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parâmetros

uiCmdID
[em] ID de comando para um elemento da faixa de opções.

bVisibleOnly
[em] TRUE pesquisar apenas elementos visíveis da faixa de opções; FALSE pesquisar todos os elementos da faixa de opções.

bExcludeQAT
[in] TRUE excluir elementos da barra de ferramentas de acesso rápido da pesquisa; caso contrário, FALSE.

Valor de retorno

Um ponteiro para um elemento da faixa de opções se ele tiver o ID de comando especificado e os valores de pesquisa; caso contrário, NULL.

Comentários

Um elemento da faixa de opções é qualquer controle da faixa de opções que pode ser adicionado à faixa de opções, como um botão da faixa de opções, uma categoria da faixa de opções ou um controle deslizante da faixa de opções.

Em geral, pode haver mais de um elemento da faixa de opções com a mesma ID de comando. Se você quiser obter ponteiros para todos os elementos da faixa de opções que usam uma ID de comando especificada, use o método CMFCRibbonBar::GetElementsByID.

`CMFCRibbonBar::FindCategoryIndexByData`

Recupera o índice da categoria da faixa de opções que contém os dados especificados.

int FindCategoryIndexByData(DWORD dwData) const;

Parâmetros

dwData
[em] Os dados associados a uma categoria da faixa de opções.

Valor de retorno

O índice baseado em zero de uma categoria de faixa de opções se o método foi bem-sucedido; caso contrário, -1.

`CMFCRibbonBar::ForceRecalcLayout`

Ajusta o layout de todos os itens na barra da faixa de opções e na janela pai e redesenha toda a janela.

void ForceRecalcLayout();

Comentários

`CMFCRibbonBar::GetActiveCategory`

Recupera um ponteiro para a categoria da faixa de opções ativa.

CMFCRibbonCategory* GetActiveCategory() const;

Valor de retorno

Um ponteiro para a categoria ativa da faixa de opções; ou NULL se nenhuma categoria estiver ativa.

Comentários

Uma categoria está ativa se tiver o foco. Por padrão, a categoria ativa é a primeira categoria no lado esquerdo da barra da faixa de opções.

A categoria principal é exibida quando o usuário pressiona o botão do aplicativo e não pode ser a categoria ativa.

`CMFCRibbonBar::GetApplicationButton`

Recupera um ponteiro para o botão do aplicativo.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Valor de retorno

Um ponteiro para o botão de aplicação; ou NULL se o botão não tiver sido definido.

`CMFCRibbonBar::GetCaptionHeight`

Recupera a altura da área de legenda da barra da faixa de opções.

int GetCaptionHeight() const;

Valor de retorno

A altura, em pixels, da área de legenda da barra da faixa de opções.

Comentários

`CMFCRibbonBar::GetCategory`

Recupera um ponteiro para a categoria da faixa de opções no índice especificado.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parâmetros

nIndex
[em] O índice baseado em zero de uma categoria de faixa de opções na lista de categorias da faixa de opções contida na barra da faixa de opções.

Valor de retorno

Um ponteiro para a categoria da faixa de opções no índice especificado; caso contrário, NULL se nIndex estivesse fora do alcance.

`CMFCRibbonBar::GetCategoryCount`

Recupera o número de categorias da faixa de opções na barra da faixa de opções.

int GetCategoryCount() const;

Valor de retorno

O número das categorias da faixa de opções na barra da faixa de opções.

`CMFCRibbonBar::GetCategoryHeight`

Recupera a altura da categoria.

int GetCategoryHeight() const;

Valor de retorno

A altura da categoria.

Comentários

A altura da categoria inclui a altura da guia categoria.

`CMFCRibbonBar::GetCategoryIndex`

Recupera o índice da categoria de faixa de opções especificada.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parâmetros

pCategory
[em] Ponteiro para uma categoria de faixa de opções.

Valor de retorno

O índice baseado em zero de uma categoria de faixa de opções especificada por pCategory; ou -1 se a categoria do friso não for encontrada.

`CMFCRibbonBar::GetContextName`

Recupera o nome da legenda da categoria de contexto especificada por uma ID de contexto.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parâmetros

uiContextID
[em] Uma ID de contexto de categoria da faixa de opções.

strName
[saídas] O nome de uma legenda de categoria de contexto.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE se uiContextID era zero ou se a legenda da categoria de contexto não foi encontrada.

`CMFCRibbonBar::GetDroppedDown`

Recupera o elemento da faixa de opções que está atualmente descartado.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Valor de retorno

O elemento da faixa de opções que está atualmente descartado; ou NULL se nenhum elemento da faixa de opções estiver descartado no momento.

Comentários

`CMFCRibbonBar::GetElementsByID`

Recupera uma matriz de ponteiros para todos os elementos da faixa de opções que têm uma ID de comando específica.

void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& arButtons);

Parâmetros

uiCmdID
[em] ID de comando de um elemento da faixa de opções.

arButtons
[saídas] Uma matriz de ponteiros para elementos da faixa de opções.

Comentários

Vários elementos da faixa de opções podem ter a mesma ID de comando porque alguns elementos da faixa de opções podem ser copiados para a barra de ferramentas de acesso rápido.

`CMFCRibbonBar::GetHideFlags`

Recupera os sinalizadores que indicam quanto da barra da faixa de opções está visível.

DWORD GetHideFlags() const;

Valor de retorno

Os sinalizadores que indicam quanto da barra da faixa de opções está visível.

Comentários

A tabela a seguir lista a combinação possível de sinalizadores para o valor de retorno:

Bandeira	Descrição
`AFX_RIBBONBAR_HIDE_ELEMENTS`	A barra do friso é minimizada verticalmente e apenas os separadores de categoria, o botão principal e a barra de ferramentas de acesso rápido são visíveis.
`AFX_RIBBONBAR_HIDE_ALL`	A largura da barra do friso é inferior à largura mínima e está completamente oculta.

`CMFCRibbonBar::GetItemIDsList`

Recupera as IDs de comando para a coleção especificada de elementos da faixa de opções na barra da faixa de opções.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parâmetros

lstItems
[saídas] A lista de IDs de comando para elementos da faixa de opções contidos na barra da faixa de opções.

bHiddenOnly
[em] TRUE para excluir elementos da faixa de opções exibidos; FALSE incluir todos os elementos da faixa de opções na barra da faixa de opções.

Comentários

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Recupera o nível de navegação atual à medida que o usuário pressiona as dicas de teclas contidas na barra da faixa de opções.

int GetKeyboardNavigationLevel() const;

Valor de retorno

O nível de navegação atual à medida que o usuário pressiona as dicas de teclas contidas na barra da faixa de opções. A tabela a seguir lista possíveis valores de retorno:

Valor	Descrição
-1	As dicas de teclas não são exibidas.
0	As dicas de teclas são exibidas.
1	O usuário pressionou uma dica de tecla exibida.

Comentários

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Recupera o objeto de navegação do teclado atual na barra da faixa de opções.

CObject* GetKeyboardNavLevelCurrent() const;

Valor de retorno

O objeto de navegação do teclado atual na barra da faixa de opções; caso contrário, NULL se nenhum objeto exibir dicas de teclas no momento.

Comentários

O objeto que está exibindo dicas de teclas no momento é o objeto de navegação do teclado atual.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Recupera o objeto de navegação do teclado pai na barra da faixa de opções.

CObject* GetKeyboardNavLevelParent() const;

Valor de retorno

O objeto de navegação do teclado pai na barra da faixa de opções; caso contrário, NULL.

Comentários

Quando o usuário pressiona uma dica de tecla na barra da faixa de opções, o objeto de navegação do teclado atual se torna o objeto de navegação do teclado pai.

`CMFCRibbonBar::GetMainCategory`

Recupera um ponteiro para a categoria principal da faixa de opções.

CMFCRibbonCategory* GetMainCategory() const;

Valor de retorno

Um ponteiro para a categoria principal da faixa de opções.

Comentários

A categoria principal da faixa de opções contém o painel principal da faixa de opções.

`CMFCRibbonBar::GetQATCommandsLocation`

Recupera o retângulo de exibição para a seção de comandos da barra de ferramentas de acesso rápido.

CRect GetQATCommandsLocation() const;

Valor de retorno

O retângulo de exibição para a seção de comandos da barra de ferramentas de acesso rápido.

Comentários

A seção de comandos do retângulo de exibição não inclui o botão de personalização.

`CMFCRibbonBar::GetQATDroppedDown`

Recupera um ponteiro para o elemento da faixa de opções na barra de ferramentas de acesso rápido que tem seu menu pop-up suspenso.

CMFCRibbonBaseElement* GetQATDroppedDown();

Valor de retorno

Um ponteiro para o elemento da faixa de opções na barra de ferramentas de acesso rápido que tem seu menu pop-up suspenso.

Comentários

`CMFCRibbonBar::GetQuickAccessCommands`

Recupera uma lista de IDs de comando para os elementos da faixa de opções na barra de ferramentas de acesso rápido.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parâmetros

lstCommands
[saídas] A lista de IDs de comando para os elementos da faixa de opções na barra de ferramentas de acesso rápido.

Comentários

A lista não contém elementos da faixa de opções que são separadores de controle.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Recupera o retângulo de exibição para a barra de ferramentas de acesso rápido.

CRect GetQuickAccessToolbarLocation() const;

Valor de retorno

O retângulo de exibição para a barra de ferramentas de acesso rápido.

Comentários

`CMFCRibbonBar::GetTabTrancateRatio`

Recupera a porcentagem de redução de tamanho na largura de exibição das guias de categoria.

int GetTabTrancateRatio() const;

Valor de retorno

A redução percentual do tamanho na largura de exibição das guias de categoria.

Comentários

As guias de categoria são reduzidas em largura quando não há largura suficiente na barra da faixa de opções.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Recupera o tamanho grande da largura da dica de ferramenta para a barra da faixa de opções.

int GetTooltipFixedWidthLargeImage() const;

Valor de retorno

O tamanho grande da largura da dica de ferramenta em pixels.

Comentários

Se o tamanho grande da largura da dica de ferramenta for 0, a largura variará.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Recupera o tamanho normal da largura da dica de ferramenta para a barra da faixa de opções.

int GetTooltipFixedWidthRegular() const;

Valor de retorno

O tamanho normal da largura da dica de ferramenta em pixels.

Comentários

Se o tamanho normal da largura da dica de ferramenta for 0, a largura varia.

`CMFCRibbonBar::GetVisibleCategoryCount`

Recupera o número de categorias visíveis na barra da faixa de opções.

int GetVisibleCategoryCount() const;

Valor de retorno

O número de categorias visíveis na barra da faixa de opções.

Comentários

`CMFCRibbonBar::HideAllContextCategories`

Oculta todas as categorias de contexto na barra da faixa de opções.

BOOL HideAllContextCategories();

Valor de retorno

TRUE se pelo menos uma categoria de contexto estivesse oculta; caso contrário, FALSE.

Comentários

Se uma categoria de contexto estiver ativa, a categoria ativa será redefinida para a primeira categoria visível na lista de categorias.

`CMFCRibbonBar::HideKeyTips`

Oculta todas as dicas de teclas na barra da faixa de opções.

void HideKeyTips();

Comentários

`CMFCRibbonBar::HitTest`

Recupera um ponteiro para o elemento da faixa de opções especificado pelo local do ponto.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parâmetros

point
[em] Localização do ponto nas coordenadas da barra do friso.

bCheckActiveCategory
[em] TRUE pesquisar a categoria ativa; FALSE não pesquisar a categoria ativa.

bCheckPanelCaption
[in] TRUE para testar a legenda do painel da faixa de opções com o ponto localizado nele; FALSE não testar a legenda do painel da faixa de opções com o ponto localizado nele. Consulte a seção Observações para obter mais informações.

Valor de retorno

Um ponteiro para o elemento da faixa de opções localizado no ponto especificado; caso contrário, NULL se o ponto não estiver localizado em um elemento da faixa de opções.

Comentários

A legenda do painel da faixa de opções com o ponto localizado nele não é testada, a menos que o parâmetro bCheckActiveCategory seja TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Indica se o recurso de dicas de teclas está habilitado.

BOOL IsKeyTipEnabled() const;

Valor de retorno

TRUE se o recurso de dicas de teclas estiver ativado; caso contrário, FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Indica se a barra da faixa de opções é a barra da faixa de opções primária.

virtual BOOL IsMainRibbonBar() const;

Valor de retorno

Sempre retorna TRUE.

Comentários

Por padrão, esse método sempre retorna TRUE. Substitua esse método para indicar se a barra da faixa de opções é a barra da faixa de opções primária.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Indica se o recurso Visualização de Impressão está habilitado.

BOOL IsPrintPreviewEnabled() const;

Valor de retorno

TRUE se a funcionalidade Print Preview estiver ativada; caso contrário, FALSE.

`CMFCRibbonBar::IsQATEmpty`

Indica se a barra de ferramentas de acesso rápido contém botões de comando.

BOOL IsQATEmpty() const;

Valor de retorno

TRUE se a barra de ferramentas de acesso rápido contiver botões de comando; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Indica se a barra de ferramentas de acesso rápido está localizada sobre ou abaixo da barra da faixa de opções.

BOOL IsQuickAccessToolbarOnTop() const;

Valor de retorno

TRUE se a barra de ferramentas de acesso rápido estiver localizada sobre a barra da faixa de opções; FALSE se a barra de ferramentas de acesso rápido estiver localizada sob a barra da faixa de opções.

`CMFCRibbonBar::IsReplaceFrameCaption`

Indica se a barra da faixa de opções substitui ou está sob a legenda da janela do quadro principal.

BOOL IsReplaceFrameCaption() const;

Valor de retorno

TRUE se a barra do friso substituir a legenda da janela do quadro principal; FALSE se a barra da faixa de opções estiver sob a legenda da janela do quadro principal.

`CMFCRibbonBar::IsShowGroupBorder`

Indica se os grupos de botões localizados na barra da faixa de opções exibem uma borda de grupo.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parâmetros

pGroup
[em] Este parâmetro não é usado.

Valor de retorno

Sempre retorna FALSE.

Comentários

Por padrão, esse método sempre retorna FALSE. Substitua esse método para indicar se os grupos de botões localizados na barra da faixa de opções exibem uma borda de grupo.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Indica se as descrições de dica de ferramenta estão habilitadas.

BOOL IsToolTipDescrEnabled() const;

Valor de retorno

TRUE se as descrições de dicas de ferramenta estiverem habilitadas; FALSE se as descrições de dica de ferramenta estiverem desabilitadas.

Comentários

As descrições da dica de ferramenta são texto descritivo adicional exibido com o texto da dica de ferramenta.

`CMFCRibbonBar::IsToolTipEnabled`

Indica se as dicas de ferramentas estão habilitadas ou desabilitadas para a barra da faixa de opções.

BOOL IsToolTipEnabled() const;

Valor de retorno

TRUE se as dicas de ferramentas estiverem habilitadas; FALSE se as dicas de ferramentas estiverem desativadas.

`CMFCRibbonBar::IsTransparentCaption`

Indica se a exibição está definida para o esquema de cores do Windows Aero.

BOOL IsTransparentCaption() const;

Valor de retorno

TRUE se o esquema de cores for Windows Aero; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::OnClickButton`

Esse método é mantido para compatibilidade com aplicativos existentes e não deve ser usado para novos desenvolvimentos.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parâmetros

pButton
[em] Ponteiro para o botão que foi clicado.

point
[em] Este parâmetro não é usado.

Comentários

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parâmetros

[em] pEdit
[em] point

Comentários

`CMFCRibbonBar::OnRTLChanged`

Chamado pela estrutura quando o layout muda de direção.

virtual void OnRTLChanged(BOOL bIsRTL);

Parâmetros

bIsRTL
[em] TRUE se o layout for da direita para a esquerda; FALSE se o layout for da esquerda para a direita.

Comentários

Esse método ajusta o layout de todos os controles na barra da faixa de opções para a nova direção do layout.

`CMFCRibbonBar::OnSetAccData`

Esse método é interno ao Framework e não se destina a ser chamado a partir do código do usuário.

BOOL OnSetAccData(long lVal);

Parâmetros

long lVal O índice do objeto acessível.

Valor de retorno

S_OK se for bem-sucedida; caso contrário, FALSE ou S_FALSE.

Comentários

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parâmetros

[em] pWnd
[em] x
[em] y
[em] pHit

Valor de retorno

Comentários

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parâmetros

[em] pWnd
[em] x
[em] y
[em] pHit

Valor de retorno

Comentários

`CMFCRibbonBar::OnSysKeyDown`

Chamado pela estrutura quando o usuário pressiona a tecla F10 ou mantém pressionada a tecla ALT e, em seguida, pressiona outra tecla.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

pFrameWnd
[em] Ponteiro para a janela do quadro principal pai da barra da faixa de opções.

wParam
[em] Código de chave virtual da tecla que está sendo pressionada.

lParam
[em] Sinalizadores de estado do teclado quando a tecla foi pressionada.

Valor de retorno

TRUE se o evento de pressionamento de tecla foi processado; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::OnSysKeyUp`

Chamado pela estrutura quando o usuário libera a tecla F10, a tecla ALT ou uma tecla que foi pressionada quando a tecla ALT foi pressionada.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

pFrameWnd
[em] Ponteiro para a janela do quadro principal pai da barra da faixa de opções.

wParam
[em] Código de chave virtual da chave que está sendo liberada.

lParam
[em] Este parâmetro não é usado.

Valor de retorno

TRUE se o evento de pressionamento de tecla foi processado; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::PopTooltip`

Remove uma dica de ferramenta do modo de exibição.

void PopTooltip();

Comentários

`CMFCRibbonBar::PreTranslateMessage`

Determina se a mensagem especificada é processada pela barra da faixa de opções.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

pMsg
[em] Ponteiro para uma mensagem.

Valor de retorno

TRUE se a mensagem foi processada pela barra da faixa de opções; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::RecalcLayout`

Ajusta o layout de todos os controles na barra da faixa de opções.

virtual void RecalcLayout();

Comentários

Após o ajuste do layout, a exibição da barra da faixa de opções é atualizada.

`CMFCRibbonBar::RemoveAllCategories`

Exclui todas as categorias da faixa de opções da barra da faixa de opções.

void RemoveAllCategories();

Comentários

Esse método exclui todas as categorias da faixa de opções da memória e da lista de categorias.

`CMFCRibbonBar::RemoveAllFromTabs`

Remove todos os elementos da faixa de opções da área da guia.

void RemoveAllFromTabs();

Comentários

Use essa função se quiser remover todos os elementos que você adicionou à área da guia usando CMFCRibbonBar::AddToTabs método.

`CMFCRibbonBar::RemoveCategory`

Exclui a categoria da faixa de opções especificada da barra da faixa de opções.

BOOL RemoveCategory(int nIndex);

Parâmetros

nIndex
[em] O índice baseado em zero de uma categoria na lista de categorias da faixa de opções contida na barra da faixa de opções.

Valor de retorno

TRUE se a categoria de faixa de opções especificada foi excluída; caso contrário, FALSE.

Comentários

A categoria da faixa de opções especificada é excluída da memória e da lista de categorias.

`CMFCRibbonBar::SetActiveCategory`

Define a categoria da faixa de opções especificada como a categoria ativa.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parâmetros

pCategory
[em] Uma categoria de faixa de opções contida na barra da faixa de opções.

bForceRestore
[em] TRUE maximizar a barra de faixa de opções se ela for minimizada; FALSE exibir a categoria ativa em uma janela pop-up se a barra da faixa de opções estiver minimizada.

Valor de retorno

TRUE se a categoria especificada foi definida como a categoria ativa; caso contrário, FALSE.

Comentários

A categoria principal da faixa de opções não pode ser a categoria ativa.

Se a categoria especificada por pCategory não for exibida, ela não poderá ser definida como a categoria ativa.

`CMFCRibbonBar::SetActiveMDIChild`

Associa os botões do sistema na barra da faixa de opções que pertencem a uma janela filho de interface de vários documentos (MDI) à janela filho MDI especificada.

void SetActiveMDIChild(CWnd* pWnd);

Parâmetros

pWnd
[em] Ponteiro para uma janela filho MDI.

Comentários

`CMFCRibbonBar::SetApplicationButton`

Atribui um botão da faixa de opções do aplicativo à barra da faixa de opções.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parâmetros

pButton
[em] Um ponteiro para o botão da faixa de opções do aplicativo.

sizeButton
[em] O tamanho do botão da faixa de opções do aplicativo.

Comentários

O botão da faixa de opções do aplicativo é um grande botão arredondado localizado no canto superior esquerdo do controle da Faixa de Opções.

Exemplo

O exemplo a seguir demonstra como usar o método SetApplicationButton na classe CMFCRibbonBar.

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Define as dicas de teclas para todos os elementos da faixa de opções que têm a ID de comando especificada.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parâmetros

uiCmdID
[em] A ID de comando de um elemento da faixa de opções.

lpszKeys
[em] A dica de chave.

lpszMenuKeys
[em] A dica de tecla do menu.

Valor de retorno

TRUE se as teclas de pelo menos um elemento da faixa de opções estiverem definidas; caso contrário, FALSE.

Comentários

A dica de menu opcional é para elementos da faixa de opções com um botão de divisão que abre um menu pop-up.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Define o nível de navegação do teclado à medida que o usuário pressiona as dicas de teclas contidas na barra da faixa de opções.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parâmetros

pLevel
[em] Ponteiro para o objeto de navegação do teclado atual.

bSetFocus
[in] TRUE definir o foco do teclado para a barra do friso.

Comentários

A navegação pelo teclado da barra de opções começa quando o usuário pressiona a ALT ou tecla F10. O usuário seleciona o próximo nível de navegação pressionando uma dica de tecla na barra da faixa de opções. O usuário pode retornar ao nível de navegação anterior pressionando a tecla de escape.

`CMFCRibbonBar::SetMaximizeMode`

Ajusta a barra da faixa de opções quando o tamanho da janela de uma janela filho de interface de vários documentos (MDI) entra ou sai do estado maximizado.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parâmetros

bMax
[in] TRUE para exibir os botões do sistema para uma janela filho MDI na barra da faixa de opções; FALSE remover os botões do sistema para uma janela filho MDI da barra da faixa de opções.

pWnd
[em] Ponteiro para a janela do quadro principal da barra da faixa de opções.

Comentários

A barra da faixa de opções exibe botões do sistema para uma janela filho MDI na linha de guia quando uma janela filho MDI é maximizada.

`CMFCRibbonBar::SetQuickAccessCommands`

Adiciona um ou mais elementos da faixa de opções à Barra de Ferramentas de Acesso Rápido.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parâmetros

lstCommands
[em] A lista de comandos a serem colocados na Barra de Ferramentas de Acesso Rápido.

bRecalcLayout
[em] TRUE se quiser redesenhar a faixa de opções depois de adicionar os elementos da faixa de opções; FALSE o contrário.

Exemplo

O exemplo a seguir demonstra como usar o método SetQuickAccessCommands na classe CMFCRibbonBar.

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

Define a barra de ferramentas de acesso rápido para o estado padrão.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parâmetros

state
[em] O estado padrão da barra de ferramentas de acesso rápido.

Comentários

O estado da barra de ferramentas de acesso rápido inclui uma lista de comandos e sua visibilidade.

Exemplo

O exemplo a seguir demonstra como usar o método SetQuickAccessDefaultState na classe CMFCRibbonBar.

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

Posiciona a barra de ferramentas de acesso rápido acima ou abaixo da barra da faixa de opções.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parâmetros

bOnTop
[in] TRUE posicionar a barra de ferramentas de acesso rápido acima da barra de opções; FALSE posicionar a barra de ferramentas de acesso rápido abaixo da barra de opções da faixa de opções.

`CMFCRibbonBar::SetTooltipFixedWidth`

Define os tamanhos regulares e grandes das larguras fixas da dica de ferramenta para a barra da faixa de opções.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parâmetros

nWidthRegular
[em] A largura, em pixels, de uma dica de ferramenta de tamanho fixo regular.

nWidthLargeImage
[em] A largura, em pixels, de uma dica de ferramenta de tamanho fixo grande.

Comentários

Definir um parâmetro como 0 faz com que a largura correspondente varie.

`CMFCRibbonBar::ShowCategory`

Mostra ou oculta a categoria de faixa de opções especificada.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parâmetros

nIndex
[em] O índice da categoria da faixa de opções.

bShow
[em] Se TRUE, mostre a categoria da faixa de opções; caso contrário, oculte a categoria da faixa de opções.

`CMFCRibbonBar::ShowContextCategories`

Mostra ou oculta as categorias de contexto que têm a ID especificada.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parâmetros

uiContextID
[em] O ID da categoria de contexto.

bShow
[em] Se TRUE, mostre as categorias que têm a ID especificada; caso contrário, oculte as categorias que têm a ID especificada.

`CMFCRibbonBar::ShowKeyTips`

Mostra as dicas de teclas para cada elemento da faixa de opções na barra da faixa de opções.

void ShowKeyTips();

Comentários

`CMFCRibbonBar::ToggleMimimizeState`

Alterna a barra da faixa de opções entre os estados minimizado e maximizado.

void ToggleMimimizeState();

Comentários

O erro ortográfico no nome do método é um problema conhecido.

No estado minimizado, o controle da faixa de opções fica oculto e somente as guias são exibidas. Quando o usuário clica em uma guia, o controle da faixa de opções é exibido como uma janela pop-up. A janela fecha quando o usuário clica ou executa um comando.

`CMFCRibbonBar::TranslateChar`

Determina se o código de caractere de pressionamento de tecla especificado é processado pela barra da faixa de opções.

virtual BOOL TranslateChar(UINT nChar);

Parâmetros

nChar
[em] Um código de caractere de pressionamento de tecla do usuário.

Valor de retorno

TRUE se o código do caractere foi processado pela barra da faixa de opções; caso contrário, FALSE.

Comentários

O recurso de dicas de teclas permite que os usuários naveguem na barra da faixa de opções usando o teclado.

`CMFCRibbonBar::GetFocused`

Retorna um elemento focado.

virtual CMFCRibbonBaseElement* GetFocused();

Valor de retorno

Um ponteiro para um elemento focado ou NULL.

Comentários

`CMFCRibbonBar::IsWindows7Look`

Indica se a faixa de opções tem uma aparência do Windows 7 (pequeno botão de aplicativo retangular).

BOOL IsWindows7Look() const;

Valor de retorno

TRUE se a faixa de opções tiver uma aparência do Windows 7; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::LoadFromResource`

Sobrecarregado. Carrega uma Barra de Faixa de Opções a partir de recursos do aplicativo.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parâmetros

uiXMLResID
Especifica a ID do recurso da cadeia de caracteres XML com informações da Barra da Faixa de Opções.

lpszResType
Especifica o tipo do recurso localizado em uiXMLResID.

hInstance
Manipule o módulo cujo arquivo executável contém o recurso. Se hInstance estiver NULL, o sistema carregará o recurso do módulo que foi usado para criar o processo atual.

lpszXMLResID
Especifica a ID do recurso (em forma de cadeia de caracteres) com informações da Barra da Faixa de Opções.

Valor de retorno

TRUE se a carga for bem-sucedida; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::SaveToXMLBuffer`

Salva a Barra da Faixa de Opções em um buffer.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parâmetros

ppBuffer
Quando essa função retorna, ppBuffer aponta para um buffer alocado por esse método e contém informações da Barra da Faixa de Opções no formato XML.

Valor de retorno

TRUE se for bem-sucedida; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::SaveToXMLFile`

Salva a Barra da Faixa de Opções em um arquivo XML.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parâmetros

lpszFilePath
Especifica o arquivo de saída.

Valor de retorno

TRUE se for bem-sucedida; caso contrário, FALSE.

Comentários

`CMFCRibbonBar::SetWindows7Look`

Habilita ou desabilita uma aparência do Windows 7 (pequeno botão de aplicativo retangular) para a Faixa de Opções.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parâmetros

bWindows7Look
TRUE define uma aparência do Windows 7; FALSE o contrário.

bRecalc
TRUE recalcula o layout da faixa de opções; FALSE o contrário.

Comentários

Ver também

Gráfico de Hierarquia
Aulas
CPane Classe
CMFCRibbonCategory Classe
CMFCRibbonPanel Classe
CMFCRibbonBaseElement Classe
Passo a passo: Atualizando o aplicativo MFC Scribble

Partilhar via

CMFCRibbonBar Classe

Sintaxe

Membros

Construtores Públicos

Métodos Públicos

Comentários

Hierarquia de herança

Requerimentos

CMFCRibbonBar::ActivateContextCategory

Parâmetros

Valor de retorno

CMFCRibbonBar::AddCategory

Parâmetros

Valor de retorno

Comentários

Exemplo

CMFCRibbonBar::AddContextCategory

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::AddMainCategory

Parâmetros

Valor de retorno

Comentários

Exemplo

CMFCRibbonBar::AddPrintPreviewCategory

Valor de retorno

Comentários

CMFCRibbonBar::AddQATOnlyCategory

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::AddToTabs

Parâmetros

Comentários

CMFCRibbonBar::CMFCRibbonBar

Parâmetros

Comentários

CMFCRibbonBar::Create

Parâmetros

Valor de retorno

Comentários

Exemplo

CMFCRibbonBar::CreateEx

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::DeactivateKeyboardFocus

Parâmetros

Comentários

CMFCRibbonBar::DrawMenuImage

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::DWMCompositionChanged

Comentários

CMFCRibbonBar::EnableKeyTips

Parâmetros

Comentários

CMFCRibbonBar::EnablePrintPreview

Parâmetros

Comentários

CMFCRibbonBar::EnableToolTips

Parâmetros

Comentários

CMFCRibbonBar::FindByData

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::FindByID

Parâmetros

Valor de retorno

Comentários

CMFCRibbonBar::FindCategoryIndexByData

Parâmetros

Valor de retorno

CMFCRibbonBar::ForceRecalcLayout

Comentários

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` Classe

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`