Classe CMFCRibbonButton

Artigo
06/10/2015

A classe de CMFCRibbonButton implementa botões que você pode posicionar os elementos da barra de fita como os painéis, barras de ferramentas de acesso rápido, e os menus pop-up.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Membros

Construtores public

Nome	Descrição
CMFCRibbonButton::CMFCRibbonButton	Constrói um objeto botão de fita.

Métodos públicos

Nome	Descrição
CMFCRibbonButton::AddSubItem	Adiciona um item de menu para o menu pop-up que está associado com o botão.
CMFCRibbonButton::CanBeStretched	Overrides ( CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	Overrides ( CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	Overrides ( CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	Overrides ( CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Retorna o índice de um item de menu pop-up que está associado com a identificação especificada de comando
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Retorna o tamanho compacta de elemento fita. Overrides ( CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Retorna o índice da imagem que está associada com o botão.
CMFCRibbonButton::GetImageSize	Retorna o tamanho da imagem do elemento de fita. Overrides ( CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Retorna o tamanho do elemento de fita em seu estado intermediária. Overrides ( CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Retorna um identificador para um menu do windows que é atribuído ao botão de fita.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Retorna o tamanho normal do elemento de fita. Overrides ( CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Retorna o texto de dica de elemento fita. Overrides ( CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Especifica se o elemento de fita tem um modo compacto. Overrides ( CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Especifica se o elemento de fita tem um modo intermediária. Overrides ( CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Determina se o elemento de fita tiver um grande para. Overrides ( CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	Overrides ( CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	Overrides ( CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Determina se você tiver habilitado o comando padrão para um botão de fita.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Determina se o menu é alinhado à direita.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	Overrides ( CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Chamado pela estrutura para desenhar o elemento de fita. Overrides ( CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Remove todos os itens de menu do menu pop-up.
CMFCRibbonButton::RemoveSubItem	Remove um item de menu do menu pop-up.
CMFCRibbonButton::SetACCData	Overrides ( CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Especifica se o botão exibe uma grande ou imagem pequena quando o usuário recolher o botão.
CMFCRibbonButton::SetDefaultCommand	Permite que o comando padrão para o botão de fita.
CMFCRibbonButton::SetDescription	Define a descrição para o elemento de fita. Overrides ( CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Atribui um índice para a imagem do botão.
CMFCRibbonButton::SetMenu	Atribui um menu pop-up para o botão de fita.
CMFCRibbonButton::SetParentCategory	Overrides ( CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Alinha o menu pop-up à direita do botão.
CMFCRibbonButton::SetText	Define o texto para o elemento de fita. Overrides ( CMFCRibbonBaseElement::SetText.)

Métodos protegidos

Nome	Descrição
CMFCRibbonButton::OnClick	Chamado pela estrutura quando o usuário clica no botão.

Exemplo

O exemplo seguinte demonstra como usar os vários métodos na classe de CMFCRibbonButton . O exemplo a seguir mostra como criar um objeto da classe de CMFCRibbonButton , atribui um menu pop-up para o botão de fita, defina a descrição do botão, remove um item de menu de menus pop-up, e direito alinhar o menu pop-up a borda do botão.

  strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button. 
    // The third parameter is a zero-based index of the button's small image in the  
    // image list of the parent category. 
    // The fourth parameter is a zero-based index of the button's large image in the  
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Comentários

Para usar um botão de fita em um aplicativo, construir o objeto botão e o adiciona à fita apropriado painel.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));