Clase CMFCRibbonSeparator

Implementa el separador de cinta de opciones.

Sintaxis

class CMFCRibbonSeparator : public CMFCRibbonBaseElement

Miembros

Constructores públicos

Nombre	Descripción
CMFCRibbonSeparator::CMFCRibbonSeparator	Construye un objeto CMFCRibbonSeparator.

Métodos públicos

Nombre	Descripción
CMFCRibbonSeparator::AddToListBox	Agrega un separador a la lista Comandos del cuadro de diálogo Personalizar. (Invalida CMFCRibbonBaseElement::AddToListBox).
CMFCRibbonSeparator::CreateObject	Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CMFCRibbonSeparator::GetThisClass	Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.

Métodos protegidos

Nombre	Descripción
CMFCRibbonSeparator::CopyFrom	Método de copia que establece las variables miembro de un separador de otro objeto.
CMFCRibbonSeparator::GetRegularSize	Devuelve el tamaño de un separador.
CMFCRibbonSeparator::IsSeparator	Indica si se trata de un separador.
CMFCRibbonSeparator::IsTabStop	Indica si se trata de una tabulación
CMFCRibbonSeparator::OnDraw	Lo llama el sistema para dibujar el separador en la cinta de opciones o en la barra de herramientas de acceso rápido.
CMFCRibbonSeparator::OnDrawOnList	Lo llama el sistema para dibujar el separador en la lista Comandos.

Comentarios

Un separador de cinta de opciones es una línea vertical u horizontal que separa lógicamente los elementos de la cinta de opciones. Se puede dibujar un separador en el control de cinta de opciones, el menú de la aplicación principal, la barra de estado de la cinta de opciones y la barra de herramientas de acceso rápido.

Para usar un separador en la aplicación, construya el nuevo objeto y agréguelo al menú de la aplicación principal, como se muestra aquí:

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

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

Llame a CMFCRibbonPanel::AddSeparator para agregar separadores a los paneles de la cinta de opciones. El método AddSeparator asigna y agrega internamente los separadores.

Jerarquía de herencia

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

Requisitos

Encabezado: afxbaseribbonelement.h

CMFCRibbonSeparator::AddToListBox

Agrega un separador a la lista Comandos del cuadro de diálogo Personalizar.

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

Parámetros

pWndListBox
[in] Puntero a la lista Comandos en la que se agrega el separador.

bDeep
[in] Ignorado.

Valor devuelto

Índice de base cero para la cadena del cuadro de lista especificado por pWndListBox.

CMFCRibbonSeparator::CMFCRibbonSeparator

Construye un objeto CMFCRibbonSeparator.

CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);

Parámetros

bIsHoriz
[in] Si es TRUE, el separador es horizontal, si es FALSE el separador es vertical.

Comentarios

Los separadores horizontales se usan en los menús de la aplicación. Los separadores verticales se usan en las barras de herramientas.

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto de la clase CMFCRibbonSeparator.

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

CMFCRibbonSeparator::CopyFrom

Método de copia que establece las variables miembro de un separador de otro objeto.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parámetros

Src
[in] Elemento de la cinta de opciones de origen desde el que se va a copiar.

CMFCRibbonSeparator::GetRegularSize

Devuelve el tamaño de un separador.

virtual CSize GetRegularSize(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contenido de dispositivo.

Valor devuelto

Tamaño del separador en el contexto determinado del dispositivo.

CMFCRibbonSeparator::IsSeparator

Indica si se trata de un separador.

virtual BOOL IsSeparator() const;

Valor devuelto

Siempre es TRUE para esta clase.

CMFCRibbonSeparator::IsTabStop

Indica si se trata de una tabulación

virtual BOOL IsTabStop() const;

Valor devuelto

Siempre es FALSE para esta clase.

Comentarios

Un separador de cinta de opciones no es una tabulación.

CMFCRibbonSeparator::OnDraw

Lo llama el sistema para dibujar el separador en la cinta de opciones o en la barra de herramientas de acceso rápido.

virtual void OnDraw(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

CMFCRibbonSeparator::OnDrawOnList

Lo llama el sistema para dibujar el separador en la lista Comandos.

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

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

strText
[in] Texto que se muestra en la lista.

nTextOffset
[in] Espaciado entre el texto y el lado izquierdo del rectángulo delimitador.

rect
[in] Especifica el rectángulo delimitador.

bIsSelected
[in] Ignorado.

bHighlighted
[in] Ignorado.

Consulte también

Gráfico de jerarquías
Clases