Classe CMFCRibbonButton

Artigo
08/25/2010

The CMFCRibbonButton classe implementa botões que você pode posicionar em elementos de BAR de faixa de opções, sistema autônomo painéis, barras de ferramentas de acesso rápido e menus pop-up.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Membros

Construtores públicos

Nome	Descrição
CMFCRibbonButton::CMFCRibbonButton	Constrói um objeto de botão da faixa de opções.

Métodos públicos

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

Métodos protegidos

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

Exemplo

O exemplo a seguir demonstra como usar os diversos métodos no CMFCRibbonButton classe. O exemplo mostra como construir um objeto do CMFCRibbonButton classe, atribuir um menu pop-up do botão da faixa de opções, conjunto a descrição do botão, remover um item de menu no menu pop-up e alinhar à direita no menu pop-up para 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 da faixa de opções em um aplicativo, construir o objeto de botão e adicione-o à faixa de opções apropriadas 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));