Compartilhar via


Classe CMFCRibbonApplicationButton

Implementa um botão especial localizado no canto superior esquerdo da janela do aplicativo. Quando clicado, o botão abre um menu que geralmente contém comandos comuns de Arquivo, como Abrir, Salvar e Encerrar.

Sintaxe

class CMFCRibbonApplicationButton : public CMFCRibbonButton

Membros

Construtores públicos

Nome Descrição
CMFCRibbonApplicationButton::CMFCRibbonApplicationButton Constrói e inicializa um objeto CMFCRibbonApplicationButton.

Métodos públicos

Nome Descrição
CMFCRibbonApplicationButton::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCRibbonApplicationButton::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCRibbonApplicationButton::SetImage Atribui uma imagem ao botão de aplicativo da faixa de opções.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCRibbonApplicationButton. O exemplo mostra como atribuir uma imagem ao botão do aplicativo e como definir sua dica de ferramenta. Esse snippet de código faz parte do exemplo Desenhar Cliente.

CMFCRibbonApplicationButton m_MainButton;
m_MainButton.SetImage(IDB_RIBBON_MAIN);
m_MainButton.SetToolTipText(_T("File"));
// Set the short cut keyboard text.
m_MainButton.SetText(_T("f"));

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonApplicationButton

Requisitos

Cabeçalho: afxRibbonBar.h

CMFCRibbonApplicationButton::CMFCRibbonApplicationButton

Constrói e inicializa um objeto CMFCRibbonApplicationButton.

CMFCRibbonApplicationButton();
CMFCRibbonApplicationButton(UINT uiBmpResID);
CMFCRibbonApplicationButton(HBITMAP hBmp);

Parâmetros

uiBmpResID
A ID do recurso da imagem a ser exibida no botão do aplicativo.

hBmp
Um identificador de bitmap a ser exibido no botão do aplicativo.

Comentários

O botão de aplicativo da faixa de opções é um botão especial localizado no canto superior esquerdo da janela do aplicativo. Quando um usuário clica nesse botão, o aplicativo abre um menu que geralmente contém comandos de Arquivo comuns, como Abrir, Salvar e Sair.

CMFCRibbonApplicationButton::SetImage

Atribui uma imagem ao botão de aplicativo.

void SetImage(UINT uiBmpResID);
void SetImage(HBITMAP hBmp);

Parâmetros

uiBmpResID
[in] A ID do recurso da imagem a ser exibida no botão do aplicativo.

hBmp
[in] Um identificador de bitmap a ser exibido no botão do aplicativo.

Comentários

Use esse método para atribuir uma nova imagem ao botão do aplicativo da faixa de opções depois de criar o botão. O botão do aplicativo está localizado no canto superior esquerdo da janela do aplicativo.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonButton