Partilhar via


Classe CMFCRibbonMainPanel

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa um painel de fita que aparece quando clicas no CMFCRibbonApplicationButton.

Sintaxe

class CMFCRibbonMainPanel : public CMFCRibbonPanel

Membros

Construtores Públicos

Nome Description
CMFCRibbonMainPanel::CMFCRibbonMainPanel Construtor padrão.
CMFCRibbonMainPanel::~CMFCRibbonMainPanel Destruidor.

Métodos Públicos

Nome Description
CMFCRibbonMainPanel::Add Adiciona um elemento de fita no painel esquerdo do painel de botões de aplicação. (Sobrepõe CMFCRibbonPanel::Add.)
CMFCRibbonMainPanel::AddRecentFilesList Adiciona uma cadeia de texto ao menu da lista de ficheiros recentes.
CMFCRibbonMainPanel::AddToBottom Adiciona um elemento de fita no painel inferior do painel de aplicação da fita.
CMFCRibbonPainelMain::AddToRight Adiciona um elemento de fita no painel direito do painel de botões de aplicação.
CMFCRibbonMainPanel::CreateObject Usado pelo framework para criar uma instância dinâmica deste tipo de classe.
CMFCRibbonMainPanel::GetCommandsFrame Devolve um retângulo que representa a área do painel principal em fita.
CMFCRibbonMainPanel::GetThisClass Usado pelo framework para obter um ponteiro para o objeto CRuntimeClass associado a este tipo de classe.

Observações

O framework mostra quando CMFCRibbonMainPanel abres o painel de aplicações. Contém três painéis:

  • O painel esquerdo contém comandos associados a ficheiros, como Abrir, Guardar, 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 se clica no painel esquerdo. Por exemplo, se clicar em Guardar Como no painel esquerdo, o painel direito pode mostrar os tipos de ficheiros disponíveis. Para adicionar um item a este painel, chame CMFCRibbonMainPanel::AddToRight.

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

Hierarquia de herança

CObject

CMFCRibbonPanel

CMFCRibbonMainPanel

Requerimentos

Cabeçalho: afxRibbonMainPanel.h

CMFCRibbonMainPanel::Add

Adiciona um elemento de fita no painel esquerdo do painel de botões de aplicação.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parâmetros

pElem
[inspira, expira] Um apontador para o elemento de fita para adicionar ao painel principal.

Observações

Adiciona um elemento de fita ao painel. Os elementos adicionados usando este método estarão localizados na coluna esquerda do painel principal.

CMFCRibbonMainPanel::AddRecentFilesList

Adiciona uma cadeia de texto ao menu da lista de ficheiros recentes.

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

Parâmetros

lpszLabel
Especifica a cadeia a adicionar à lista de ficheiros recentes.

nLargura
Especifica a largura, em pixels, do painel da lista de ficheiros recentes.

Observações

CMFCRibbonMainPanel::AddToBottom

Adiciona um elemento de fita no painel inferior do painel de aplicação da fita.

void AddToBottom(CMFCRibbonMainPanelButton* pElem);

Parâmetros

pElem
[inspira, expira] Um apontador para o elemento de fita para adicionar na parte inferior do painel principal.

Observações

CMFCRibbonPainelMain::AddToRight

Adiciona um elemento de fita no painel direito do painel de botões de aplicação.

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

Parâmetros

pElem
Um ponteiro para um elemento de fita a ser adicionado no lado direito do painel principal.

nLargura
Especifica a largura, em píxeis, do painel direito.

Observações

Use esta função para adicionar um elemento de fita ao painel direito. O painel direito normalmente mostra a lista de ficheiros recentes, mas pode adicionar qualquer outro elemento de fita aqui.

CMFCRibbonMainPanel::GetCommandsFrame

Devolve um retângulo que representa a área do painel principal em fita.

CRect GetCommandsFrame() const;

Valor de retorno

Um retângulo que representa a área do painel principal em fita.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonPanel