Classe CMFCRibbonSeparator
Implementa o separador da faixa de opções.
Sintaxe
class CMFCRibbonSeparator : public CMFCRibbonBaseElement
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonSeparator::CMFCRibbonSeparator | Constrói um objeto CMFCRibbonSeparator. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonSeparator::AddToListBox | Adiciona um separador à lista Comandos na caixa de diálogo Personalizar. (Overrides CMFCRibbonBaseElement::AddToListBox.) |
CMFCRibbonSeparator::CreateObject |
Usado pela estrutura para criar uma instância dinâmica desse tipo de classe. |
CMFCRibbonSeparator::GetThisClass |
Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe. |
Métodos protegidos
| Nome | Descrição |
|---|---|
| CMFCRibbonSeparator::CopyFrom | Um método de cópia que define variáveis de membro de um separador de outro objeto. |
| CMFCRibbonSeparator::GetRegularSize | Retorna o tamanho de um separador. |
| CMFCRibbonSeparator::IsSeparator | Indica se esse é um separador. |
| CMFCRibbonSeparator::IsTabStop | Indica se esta é uma parada de tabulação. |
| CMFCRibbonSeparator::OnDraw | Chamado pelo sistema para desenhar o separador na faixa de opções ou na Barra de Ferramentas de Acesso Rápido. |
| CMFCRibbonSeparator::OnDrawOnList | Chamado pelo sistema para desenhar o separador na lista Comandos. |
Comentários
Um separador de faixa de opções é uma linha vertical ou horizontal que separa logicamente os elementos da faixa de opções. Um separador pode ser desenhado no controle da faixa de opções, no menu principal do aplicativo, na barra de status da faixa de opções e na Barra de Ferramentas de Acesso Rápido.
Para usar um separador em seu aplicativo, construa o objeto e adicione-o ao menu principal do aplicativo, conforme mostrado aqui:
CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
IDB_FILESMALL,
IDB_FILELARGE);
...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
Chame CMFCRibbonPanel::AddSeparator para adicionar separadores aos painéis da faixa de opções. Os separadores são alocados e adicionados internamente pelo método AddSeparator.
Hierarquia de herança
Requisitos
Cabeçalho: afxbaseribbonelement.h
CMFCRibbonSeparator::AddToListBox
Adiciona um separador à lista Comandos na caixa de diálogo Personalizar.
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
Parâmetros
pWndListBox
[in] Um ponteiro para a lista Comandos em que o separador é adicionado.
bDeep
[in] Ignorado.
Valor de retorno
Índice baseado em zero para a cadeia de caracteres na caixa de listagem especificada por pWndListBox.
CMFCRibbonSeparator::CMFCRibbonSeparator
Constrói um objeto CMFCRibbonSeparator.
CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);
Parâmetros
bIsHoriz
[in] Se TRUE, o separador será horizontal; se FALSE, o separador será vertical.
Comentários
Separadores horizontais são usados em menus de aplicativo. Separadores verticais são usados em barras de ferramentas.
Exemplo
O exemplo a seguir demonstra como construir um objeto da classe CMFCRibbonSeparator.
// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
CMFCRibbonSeparator::CopyFrom
Um método de cópia que define variáveis de membro de um separador de outro objeto.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parâmetros
Src
[in] O elemento da faixa de opções de origem do qual copiar.
CMFCRibbonSeparator::GetRegularSize
Retorna o tamanho de um separador.
virtual CSize GetRegularSize(CDC* pDC);
Parâmetros
pDC
[in] Um ponteiro para o conteúdo de um dispositivo.
Valor de retorno
O tamanho do separador no contexto de dispositivo fornecido.
CMFCRibbonSeparator::IsSeparator
Indica se esse é um separador.
virtual BOOL IsSeparator() const;
Valor de retorno
Sempre TRUE para esta classe.
CMFCRibbonSeparator::IsTabStop
Indica se esta é uma parada de tabulação.
virtual BOOL IsTabStop() const;
Valor de retorno
Sempre FALSE para esta classe.
Comentários
Um separador de faixa de opções não é uma parada de tabulação.
CMFCRibbonSeparator::OnDraw
Chamado pelo sistema para desenhar o separador na faixa de opções ou na Barra de Ferramentas de Acesso Rápido.
virtual void OnDraw(CDC* pDC);
Parâmetros
pDC
[in] Um ponteiro para um contexto de dispositivo.
CMFCRibbonSeparator::OnDrawOnList
Chamado pelo sistema para desenhar o separador na lista Comandos.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parâmetros
pDC
[in] Um ponteiro para um contexto de dispositivo.
strText
[in] Texto exibido na lista.
nTextOffset
[in] Espaçamento entre o texto e o lado esquerdo do retângulo delimitador.
rect
[in] Especifica o retângulo delimitador.
bIsSelected
[in] Ignorado.
bHighlighted
[in] Ignorado.