Clase CMFCRibbonStatusBarPane

La clase CMFCRibbonStatusBarPane implementa un elemento de cinta que puede agregar a una barra de estado de la cinta.

Sintaxis

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Miembros

Constructores públicos

Nombre	Descripción
CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane	Construye e inicializa un objeto CMFCRibbonStatusBarPane.

Métodos públicos

Nombre	Descripción
CMFCRibbonStatusBarPane::GetAlmostLargeText	Devuelve la cadena que define la cadena de texto más larga que se puede mostrar en el panel sin truncamiento.
CMFCRibbonStatusBarPane::GetTextAlign	Devuelve la configuración actual de la alineación del texto.
CMFCRibbonStatusBarPane::IsAnimation	Determina si la animación está en curso.
CMFCRibbonStatusBarPane::IsExtended	Determina si el panel se encuentra en el área extendida de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBarPane::OnDrawBorder	(Invalida CMFCRibbonButton::OnDrawBorder.)
CMFCRibbonStatusBarPane::OnFillBackground	(Invalida CMFCRibbonButton::OnFillBackground.)
CMFCRibbonStatusBarPane::SetAlmostLargeText	Define la cadena de texto más larga que se puede mostrar en el panel sin truncamiento.
CMFCRibbonStatusBarPane::SetAnimationList	Asigna al panel una lista de imágenes que se puede usar para la animación.
CMFCRibbonStatusBarPane::SetTextAlign	Establece la alineación del texto.
CMFCRibbonStatusBarPane::StartAnimation	Inicia la animación que se asigna al panel.
CMFCRibbonStatusBarPane::StopAnimation	Detiene la animación que se asigna al panel. .

Métodos protegidos

Nombre	Descripción
CMFCRibbonStatusBarPane::OnFinishAnimation	Lo llama el marco cuando se detiene la animación asignada al panel.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCRibbonStatusBarPane. En el ejemplo se muestra cómo construir un objeto CMFCRibbonStatusBarPane, establecer la alineación de texto de la etiqueta del panel de barras de estado, definir el texto más largo que se puede mostrar en el panel de la barra de estado sin truncamiento, adjuntar al panel de barras de estado una lista de imágenes que se puede usar para la animación e iniciar la animación.

CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);

CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();

Jerarquía de herencia

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Requisitos

Encabezado: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

Construye un objeto de panel en la barra de estado.

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    BOOL bIsStatic=FALSE,
    HICON hIcon=NULL,
    LPCTSTR lpszAlmostLargeText=NULL);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192,192 1,192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

Parámetros

nCmdID
[in] Especifica el identificador de comando del panel.

lpszText
[in] Especifica la cadena de texto que se va a mostrar en el panel.

bIsStatic
[in] Si es TRUE, el panel de estado no se puede resaltar o seleccionar haciendo clic en él.

hIcon
[in] Especifica un identificador para un icono que se va a mostrar en el panel.

lpszAlmostLargeText
[in] Especifica la cadena de texto más larga que el panel puede mostrar.

hBmpAnimationList
[in] Especifica un identificador para una lista de imágenes que se usa para la animación.

cxAnimation
[in] Especifica el ancho, en píxeles, del icono de la lista de imágenes que se usa para la animación.

clrTrnsp
[in] Especifica el color transparente de las imágenes de la lista de imágenes que se usan para la animación.

uiAnimationListResID
[in] Especifica un identificador de recurso de una lista de imágenes que se usa para la animación.

CMFCRibbonStatusBarPane::GetAlmostLargeText

Obtiene la cadena de texto más larga que puede mostrar el panel de la barra de estado.

LPCTSTR GetAlmostLargeText() const;

Valor devuelto

La cadena de texto más larga que puede mostrar el panel de la barra de estado.

CMFCRibbonStatusBarPane::GetTextAlign

Obtiene la configuración actual de la alineación de texto de la etiqueta del panel de la barra de estado.

int GetTextAlign() const;

Valor devuelto

La alineación del texto actual, que puede ser una de las siguientes:

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

Determina si la animación está en curso.

BOOL IsAnimation() const;

Valor devuelto

TRUE si la animación está en curso; FALSE en caso contrario.

CMFCRibbonStatusBarPane::IsExtended

Determina si el panel se encuentra en el área extendida de la barra de estado de la cinta de opciones.

BOOL IsExtended() const;

Valor devuelto

TRUE si el panel está en el área extendida de la barra de estado. FALSE en caso contrario.

CMFCRibbonStatusBarPane::OnDrawBorder

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

virtual void OnDrawBorder(CDC*);

Parámetros

[in] CDC*

Comentarios

CMFCRibbonStatusBarPane::OnFillBackground

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

virtual COLORREF OnFillBackground(CDC* pDC);

Parámetros

[in] pDC

Valor devuelto

Comentarios

CMFCRibbonStatusBarPane::OnFinishAnimation

El marco llama a este método cuando finaliza la animación asignada al panel.

virtual void OnFinishAnimation();

Comentarios

el método StopAnimation llama al método OnFinishAnimation, que se puede usar para limpiar los datos cuando finaliza la animación.

CMFCRibbonStatusBarPane::SetAlmostLargeText

Define el texto más largo que se puede mostrar en el panel de la barra de estado sin truncamiento.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Parámetros

lpszAlmostLargeText
[in] Especifica la cadena más larga que se puede mostrar en el panel de la barra de estado sin truncamiento.

Comentarios

La biblioteca calcula el tamaño del texto que lpszAlmostLargeText especifica y cambia el tamaño del panel según corresponda. El texto se truncará si todavía no cabe en el panel.

CMFCRibbonStatusBarPane::SetAnimationList

Adjunta al panel de la barra de estado una lista de imágenes que se puede usar para la animación.

void SetAnimationList(
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

BOOL SetAnimationList(
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

Parámetros

hBmpAnimationList
[in] Especifica un identificador para una lista de imágenes.

cxAnimation
[in] Especifica el ancho, en píxeles, del marco de la lista de imágenes.

clrTransp
Especifica el color transparente de la imagen.

uiAnimationListResID
[in] Especifica el identificador de recurso de la lista de imágenes.

Valor devuelto

TRUE si la lista de imágenes se adjunta correctamente al panel de la barra de estado; FALSE en caso contrario.

CMFCRibbonStatusBarPane::SetTextAlign

Establece la alineación de texto de la etiqueta del panel de la barra de estado.

void SetTextAlign(int nAlign);

Parámetros

nAlign
[in] Especifica la alineación del texto.

Comentarios

nAlign puede tener uno de los siguientes valores:

• TA_LEFT: alineación izquierda

• TA_CENTER: alineación central

• TA_RIGHT: alineación derecha

CMFCRibbonStatusBarPane::StartAnimation

Inicia la animación que se asigna al panel.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

Parámetros

nFrameDelay
[in] Especifica la velocidad de fotogramas de la animación, en milisegundos.

nDuration
[in] Especifica cuánto tiempo se tarda en reproducir la animación, en milisegundos. Usa -1 para un bucle infinito.

Comentarios

Debes especificar un identificador para una lista de imágenes antes de llamar a StartAnimation usando SetAnimationList.

CMFCRibbonStatusBarPane::StopAnimation

Detiene la animación que asignó al panel de la barra de estado.

void StopAnimation();

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonButton (clase)
CMFCRibbonStatusBar (clase)