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
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.