Classe Separadora CMFCRibbon

Implementa o separador de fita.

Sintaxe

class CMFCRibbonSeparator : public CMFCRibbonBaseElement

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Observações

Um separador de fita é uma linha vertical ou horizontal que separa logicamente os elementos da fita. Um separador pode ser desenhado no controlo da fita, no menu principal da aplicação, na barra de estado da fita e na Barra de Ferramentas de Acesso Rápido.

Para usar um separador na sua aplicação, construa o novo objeto e adicione-o ao menu principal da aplicação, como mostrado aqui:

CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
    IDB_FILESMALL,
    IDB_FILELARGE);

...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

Ligue para CMFCRibbonPanel::AddSeparator para adicionar separadores aos painéis de fita. Os separadores são alocados e adicionados internamente pelo AddSeparator método.

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

Requerimentos

Cabeçalho: afxbaseribbonelement.h

CMFCRibbonSeparator::AddToListBox

Adiciona um separador à lista de Comandos na caixa de diálogo Personalizar .

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parâmetros

pWndListBox
[dentro] Um apontador para a lista de Comandos onde o separador é adicionado.

bDeep
[dentro] Ignorado.

Valor de retorno

Índice baseado em zero para a cadeia na caixa de lista especificada por pWndListBox.

CMFCRibbonSeparator::CMFCRibbonSeparator

Constrói um CMFCRibbonSeparator objeto.

CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);

Parâmetros

bIsHoriz
[dentro] Se TRUE, o separador é horizontal; se FALSE, o separador é vertical.

Observações

Separadores horizontais são usados nos menus de aplicação. Os separadores verticais são usados nas barras de ferramentas.

Example

O exemplo seguinte demonstra como construir um objeto da CMFCRibbonSeparator classe.

// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

CMFCRibbonSeparator::CopyFrom

Um método de cópia que define as variáveis membros de um separador a partir de outro objeto.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parâmetros

Src
[dentro] O elemento de fita de origem para copiar.

CMFCRibbonSeparator::GetRegularSize

Devolve o tamanho de um separador.

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

pDC
[dentro] Um apontador para o conteúdo de um dispositivo.

Valor de retorno

O tamanho do separador no contexto dado do dispositivo.

CMFCRibbonSeparator::IsSeparator

Indica se isto é um separador.

virtual BOOL IsSeparator() const;

Valor de retorno

Sempre VERDADE para esta aula.

CMFCRibbonSeparator::IsTabStop

Indica se isto é um tab stop.

virtual BOOL IsTabStop() const;

Valor de retorno

Sempre FALSO nesta aula.

Observações

Um separador de fita não é um separador de aba.

CMFCRibbonSeparator::OnDraw

Chamado pelo sistema para desenhar o separador na fita ou na Barra de Ferramentas de Acesso Rápido.

virtual void OnDraw(CDC* pDC);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

CMFCRibbonSeparator::OnDrawOnList

Chamado pelo sistema para desenhar o separador na lista de Comandos .

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

strText
[dentro] Texto mostrado na lista.

nTextOffset
[dentro] Espaçamento entre o texto e o lado esquerdo do retângulo delimitador.

retângulo
[dentro] Especifica o retângulo delimitador.

bIsSelected
[dentro] Ignorado.

bDestacado
[dentro] Ignorado.

Consulte também

Gráfico de Hierarquia
Classes