Partilhar via


Classe CMFCRibbonMainPanel

Implementa um painel de faixa de opções que é exibido quando você clica em CMFCRibbonApplicationButton.

Sintaxe

class CMFCRibbonMainPanel : public CMFCRibbonPanel

Membros

Construtores públicos

Nome Descrição
CMFCRibbonMainPanel::CMFCRibbonMainPanel Construtor padrão.
CMFCRibbonMainPanel::~CMFCRibbonMainPanel Destruidor.

Métodos públicos

Nome Descrição
CMFCRibbonMainPanel::Add Adiciona um elemento de faixa de opções ao painel esquerdo do painel de botões do aplicativo. (Substitui CMFCRibbonPanel::Add.)
CMFCRibbonMainPanel::AddRecentFilesList Adiciona uma cadeia de caracteres de texto ao menu de lista de arquivos recentes.
CMFCRibbonMainPanel::AddToBottom Adiciona um elemento de faixa de opções ao painel inferior do painel de aplicativos da faixa de opções.
CMFCRibbonMainPanel::AddToRight Adiciona um elemento de faixa de opções ao painel direito do painel de botões do aplicativo.
CMFCRibbonMainPanel::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCRibbonMainPanel::GetCommandsFrame Retorna um retângulo que representa a área do painel principal da faixa de opções.
CMFCRibbonMainPanel::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.

Comentários

A estrutura exibe o CMFCRibbonMainPanel quando você abre o painel de aplicativos. Ele contém três painéis:

  • O painel esquerdo contém comandos associados a arquivos, como Abrir, Salvar, Imprimir e Fechar. Para adicionar um comando a este painel, chame CMFCRibbonMainPanel::Add.

  • O painel direito contém opções que modificam o comando que você clica no painel esquerdo. Por exemplo, se você clicar em Salvar como no painel esquerdo, o painel direito poderá exibir os tipos de arquivo disponíveis. Para adicionar um item a este painel, chame CMFCRibbonMainPanel::AddToRight.

  • O painel inferior contém botões que permitem alterar as configurações do aplicativo e sair do programa. Para adicionar um item a este painel, chame CMFCRibbonMainPanel::AddToBottom.

Hierarquia de herança

CObject

CMFCRibbonPanel

CMFCRibbonMainPanel

Requisitos

Cabeçalho: afxRibbonMainPanel.h

CMFCRibbonMainPanel::Add

Adiciona um elemento de faixa de opções ao painel esquerdo do painel de botões do aplicativo.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parâmetros

pElem
[in, out] Um ponteiro para o elemento da faixa de opções a ser adicionado ao painel principal.

Comentários

Adiciona um elemento de faixa de opções ao painel. Os elementos adicionados usando esse método estarão localizados na coluna esquerda do painel principal.

CMFCRibbonMainPanel::AddRecentFilesList

Adiciona uma cadeia de caracteres de texto ao menu de lista de arquivos recentes.

void AddRecentFilesList(
    LPCTSTR lpszLabel,
    int nWidth = 300);

Parâmetros

lpszLabel
Especifica a cadeia de caracteres a ser adicionada à lista de arquivos recentes.

nWidth
Especifica a largura, em pixels, do painel de lista de arquivos.

Comentários

CMFCRibbonMainPanel::AddToBottom

Adiciona um elemento de faixa de opções ao painel inferior do painel de aplicativos da faixa de opções.

void AddToBottom(CMFCRibbonMainPanelButton* pElem);

Parâmetros

pElem
[in, out] Um ponteiro para o elemento da faixa de opções a ser adicionado à parte inferior do painel principal.

Comentários

CMFCRibbonMainPanel::AddToRight

Adiciona um elemento de faixa de opções ao painel direito do painel de botões do aplicativo.

void AddToRight(
    CMFCRibbonBaseElement* pElem,
    int nWidth = 300);

Parâmetros

pElem
Um ponteiro para um elemento de faixa de opções a ser adicionado ao lado direito do painel principal.

nWidth
Especifica a largura, em pixels, do painel direito.

Comentários

Use essa função para adicionar um elemento de faixa de opções ao painel direito. O painel direito normalmente exibe a lista de arquivos recentes, mas você pode adicionar qualquer outro elemento da faixa de opções aqui.

CMFCRibbonMainPanel::GetCommandsFrame

Retorna um retângulo que representa a área do painel principal da faixa de opções.

CRect GetCommandsFrame() const;

Valor de retorno

Um retângulo que representa a área do painel principal da faixa de opções.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonPanel