CMFCRibbonCheckBox (clase)

La clase CMFCRibbonCheckBox implementa una casilla que se puede agregar a un menú emergente, a la barra de herramientas de acceso rápido o al panel de cinta de opciones.

Sintaxis

class CMFCRibbonCheckBox : public CMFCRibbonButton

Miembros

Constructores públicos

Nombre	Descripción
CMFCRibbonCheckBox::CMFCRibbonCheckBox	Constructor .

Métodos públicos

Nombre	Descripción
CMFCRibbonCheckBox::GetCompactSize	(Invalida CMFCRibbonButton::GetCompactSize).
CMFCRibbonCheckBox::GetIntermediateSize	(Invalida CMFCRibbonButton::GetIntermediateSize).
CMFCRibbonCheckBox::GetRegularSize	(Invalida CMFCRibbonButton::GetRegularSize).
CMFCRibbonCheckBox::IsDrawTooltipImage	(Invalida CMFCRibbonButton::IsDrawTooltipImage).
CMFCRibbonCheckBox::OnDraw	(Invalida CMFCRibbonButton::OnDraw).
CMFCRibbonCheckBox::OnDrawMenuImage	(Invalida CMFCRibbonBaseElement::OnDrawMenuImage).
CMFCRibbonCheckBox::OnDrawOnList	(Invalida CMFCRibbonButton::OnDrawOnList).
CMFCRibbonCheckBox::SetACCData	(Invalida CMFCRibbonButton::SetACCData).

Comentarios

Para usar un elemento CMFCRibbonCheckBox en su aplicación, agregue el siguiente constructor al código:

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

nID es el identificador de comando de la casilla y lpszText la etiqueta de texto de la casilla.

Para agregar una casilla a un panel de cinta de opciones, use CMFCRibbonPanel::Add.

Jerarquía de herencia

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

Requisitos

Encabezado: afxribboncheckbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

Constructor de un objeto de casilla de cinta de opciones

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

Parámetros

Nid
[in] Especifica el identificador de comando.

lpszText
[in] Especifica la etiqueta de texto.

Valor devuelto

Construye un objeto de casilla de cinta de opciones.

Ejemplo

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

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox::GetCompactSize

Cuando se invalida, obtiene el tamaño compacto de la casilla.

virtual CSize GetCompactSize(CDC* pDC);

Parámetros

pDC
[in] Puntero al CDC asociado a la casilla.

Valor devuelto

Devuelve un objeto CSize que contiene el tamaño compacto de la casilla.

Comentarios

Si no se invalida, devuelve el tamaño intermedio de la casilla.

CMFCRibbonCheckBox::GetIntermediateSize

Recupera el tamaño intermedio de la casilla.

virtual CSize GetIntermediateSize(CDC* pDC);

Parámetros

pDC
[in] Puntero al CDC asociado a esta casilla.

Valor devuelto

Objeto CSize que contiene el tamaño intermedio de la casilla.

Comentarios

Si no se invalida, calcula el tamaño intermedio como tamaño de casilla predeterminado ( AFX_CHECK_BOX_DEFAULT_SIZE) más el tamaño del texto, más los márgenes.

CMFCRibbonCheckBox::GetRegularSize

Obtiene el tamaño normal de la casilla.

virtual CSize GetRegularSize(CDC* pDC);

Parámetros

pDC
[in] Puntero al objeto CDC asociado a esta casilla.

Valor devuelto

Devuelve un objeto CSize que contiene el tamaño normal de la casilla.

Comentarios

Si no se invalida, devuelve el tamaño intermedio de la casilla.

CMFCRibbonCheckBox::IsDrawTooltipImage

Indica si hay una imagen de información sobre herramientas asociada a la casilla.

virtual BOOL IsDrawTooltipImage() const;

Valor devuelto

Devuelve TRUE si hay una imagen de información sobre herramientas asociada a la casilla o FALSE si no.

Comentarios

CMFCRibbonCheckBox::OnDraw

Lo llama el marco para dibujar la casilla mediante un contexto de dispositivo especificado.

virtual void OnDraw(CDC* pDC);

Parámetros

pDC
[in] Puntero al CDC en el que se va a dibujar la casilla.

Comentarios

CMFCRibbonCheckBox::OnDrawMenuImage

Llamado por el marco para dibujar una imagen de menú para la casilla.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Parámetros

[in] CDC*
Puntero al CDC asociado a la casilla.

CRect
[in] Objeto CRect que especifica el rectángulo en el que se va a dibujar la imagen de menú.

Valor devuelto

Devuelve TRUE si la imagen se ha dibujado o FALSE si no es así.

Comentarios

Si no se reemplaza, este método devuelve FALSE.

CMFCRibbonCheckBox::OnDrawOnList

Lo llama el marco para dibujar la casilla del cuadro de lista de comandos.

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

Parámetros

pDC
[in] Puntero al contexto del dispositivo en el que se va a dibujar la casilla.

strText
[in] Texto para mostrar.

nTextOffset
[in] La distancia, en píxeles, desde el lado izquierdo del cuadro de la lista hasta el texto para mostrar.

rect
[in] Rectángulo de presentación para la casilla.

bIsSelected
[in] TRUE si la casilla está activada o FALSE si no es así.

bHighlighted
[in] TRUE si la casilla está resaltada o FALSE si no es así.

Comentarios

CMFCRibbonCheckBox::SetACCData

Establece los datos de accesibilidad de la casilla.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parámetros

pParent
Ventana primaria de la casilla.

data
Los datos de accesibilidad de la casilla.

Valor devuelto

Siempre devuelve TRUE.

Comentarios

De forma predeterminada, este método establece los datos de accesibilidad para la casilla y siempre devuelve TRUE. Invalide este método para establecer los datos de accesibilidad y devolver un valor que indique éxito o error.

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonPanel (clase)