Compartir a través de

Clase CMFCRibbonStatusBar

  • Artículo

La clase CMFCRibbonStatusBar implementa un control de barra de estado que puede mostrar elementos de la cinta de opciones.

Sintaxis

class CMFCRibbonStatusBar : public CMFCRibbonBar

Miembros

Métodos públicos

Nombre Descripción
CMFCRibbonStatusBar::AddDynamicElement Agrega un elemento dinámico a la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::AddElement Agrega un nuevo elemento de cinta de opciones a la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::AddExtendedElement Agrega un elemento de cinta de opciones al área extendida de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::AddSeparator Agrega un separador a la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::Create Crea una barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::CreateEx Crea una barra de estado de la cinta de opciones con un estilo extendido.
CMFCRibbonStatusBar::FindByID
CMFCRibbonStatusBar::FindElement Devuelve un puntero al elemento que tiene el id. de comando especificado.
CMFCRibbonStatusBar::GetCount Devuelve el número de elementos que se encuentran en el área principal de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::GetElement Devuelve un puntero al elemento que se encuentra en un índice especificado.
CMFCRibbonStatusBar::GetExCount Devuelve el número de elementos que se encuentran en el área extendida de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::GetExElement Devuelve un puntero al elemento ubicado en el índice especificado en el área extendida de la barra de estado de la cinta.
CMFCRibbonStatusBar::GetExtendedArea
CMFCRibbonStatusBar::GetSpace
CMFCRibbonStatusBar::IsBottomFrame
CMFCRibbonStatusBar::IsExtendedElement
CMFCRibbonStatusBar::IsInformationMode Determina si el modo de información está habilitado para la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::RecalcLayout (Invalida a CMFCRibbonBar::RecalcLayout).
CMFCRibbonStatusBar::RemoveAll Quita todos los elementos de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::RemoveElement Quita el elemento que tiene un id. de comando especificado de la barra de estado de la cinta de opciones.
CMFCRibbonStatusBar::SetInformation Habilita o deshabilita el modo de información de la barra de estado de la cinta de opciones.

Métodos protegidos

Nombre Descripción
CMFCRibbonStatusBar::OnDrawInformation Muestra la cadena de información que aparece en la barra de estado de la cinta de opciones cuando el modo de información está habilitado.

Comentarios

Los usuarios pueden cambiar la visibilidad de los elementos de la cinta de opciones en una barra de estado de la cinta de opciones mediante el menú contextual integrado de la barra de estado de la cinta de opciones. Puede agregar o quitar elementos dinámicamente.

Una barra de estado de la cinta de opciones tiene dos áreas: una principal y una extendida. El área extendida se muestra en el lado derecho de la barra de estado de la cinta de opciones y aparece en un color diferente al del área principal.

Normalmente, en el área principal de la barra de estado se muestran notificaciones de estado y en el área extendida se muestran los controles de vista. El área extendida permanece visible tanto tiempo como sea posible cuando el usuario cambia el tamaño de la barra de estado de la cinta de opciones.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCRibbonStatusBar . En el ejemplo se muestra cómo agregar un elemento nuevo de la cinta de opciones a la barra de estado de la cinta de opciones, agregar un elemento de cinta al área extendida de la barra de estado de la cinta de opciones, agregar un separador y habilitar el modo normal para la barra de estado de la cinta de opciones.

// CMFCRibbonStatusBar  m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
                                  strTitlePane2);

m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

CMFCRibbonStatusBar

Requisitos

Encabezado: afxribbonstatusbar.h

CMFCRibbonStatusBar::AddDynamicElement

Agrega un elemento dinámico a la barra de estado de la cinta de opciones.

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

Parámetros

pElement
[in] Puntero a un elemento dinámico.

Comentarios

A diferencia de los elementos normales, los elementos dinámicos no son personalizables y el menú de personalización de la barra de estado no los muestra.

CMFCRibbonStatusBar::AddElement

Agrega un nuevo elemento de cinta de opciones a la barra de estado de la cinta de opciones.

void AddElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parámetros

pElement
[in] Puntero al elemento agregado.

lpszLabel
[in] Etiqueta de texto del elemento.

bIsVisible
[in] TRUE si quiere agregar el elemento como visible, FALSE si quiere agregar el elemento como oculto.

CMFCRibbonStatusBar::AddExtendedElement

Agrega un elemento de cinta de opciones al área extendida de la barra de estado de la cinta de opciones.

void AddExtendedElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

Parámetros

pElement
[in] Puntero al elemento agregado.

lpszLabel
[in] Etiqueta de texto del elemento.

bIsVisible
[in] TRUE si quiere agregar el elemento como visible, FALSE si quiere agregar el elemento como oculto.

Comentarios

El área extendida está a la derecha del control de barra de estado.

CMFCRibbonStatusBar::AddSeparator

Agrega un separador a la barra de estado de la cinta de opciones.

void AddSeparator();

Comentarios

El marco agrega un separador después del método CMFCRibbonStatusBar::AddElement. inserta el último elemento.

CMFCRibbonStatusBar::Create

Crea una barra de estado de la cinta de opciones.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parámetros

pParentWnd
[in] Puntero a la ventana primaria.

dwStyle
[in] Combinación OR lógica de estilos de control.

Nid
[in] Id. de control de la barra de estado.

Valor devuelto

Es TRUE si la barra de estado se crea correctamente; de lo contrario, es FALSE.

CMFCRibbonStatusBar::CreateEx

Crea una barra de estado de la cinta de opciones que tiene un estilo extendido.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=0,
    DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
    UINT nID=AFX_IDW_STATUS_BAR);

Parámetros

pParentWnd
Puntero a la ventana primaria.

dwCtrlStyle
Combinación OR lógica de estilos adicionales para crear el objeto de barra de estado.

dwStyle
Estilo de control de la barra de estado.

Nid
Id. de control de la barra de estado.

Valor devuelto

Es TRUE si la barra de estado se crea correctamente; de lo contrario, es FALSE.

CMFCRibbonStatusBar::FindByID

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.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);

Parámetros

[in] uiCmdID
[in] BOOL

Valor devuelto

Comentarios

CMFCRibbonStatusBar::FindElement

Devuelve un puntero al elemento que tiene el id. de comando especificado.

CMFCRibbonBaseElement* FindElement(UINT uiID);

Parámetros

uiID
[in] Id. del elemento.

Valor devuelto

Puntero al elemento que tiene el id. de comando especificado. NULL si no hay ningún elemento de este tipo.

CMFCRibbonStatusBar::GetCount

Devuelve el número de elementos que se encuentran en el área principal de la barra de estado de la cinta de opciones.

int GetCount() const;

Valor devuelto

Número de elementos que se encuentran en el área principal de la barra de estado de la cinta de opciones.

CMFCRibbonStatusBar::GetElement

Devuelve un puntero al elemento que se encuentra en un índice especificado.

CMFCRibbonBaseElement* GetElement(int nIndex);

Parámetros

nIndex
[in] Especifica un índice de base cero de un elemento ubicado en el área principal del control de barra de estado.

Valor devuelto

Puntero al elemento que se encuentra en el índice especificado. NULL si el índice es negativo o supera el número de elementos de la barra de estado.

Comentarios

CMFCRibbonStatusBar::GetExCount

Devuelve el número de elementos que se encuentran en el área extendida de la barra de estado de la cinta de opciones.

int GetExCount() const;

Valor devuelto

Número de elementos que se encuentran en el área extendida de la barra de estado de la cinta de opciones.

CMFCRibbonStatusBar::GetExElement

Devuelve un puntero al elemento ubicado en el índice especificado en el área extendida de la barra de estado de la cinta. El área extendida está a la derecha del control de barra de estado.

CMFCRibbonBaseElement* GetExElement(int nIndex);

Parámetros

nIndex
[in] Especifica el índice de base cero de un elemento ubicado en el área extendida del control de barra de estado.

Valor devuelto

Puntero al elemento ubicado en el índice especificado en el área extendida de la barra de estado de la cinta. NULL si nIndex es negativo o supera el número de elementos del área extendida de la barra de estado de la cinta de opciones.

Comentarios

CMFCRibbonStatusBar::GetExtendedArea

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 BOOL GetExtendedArea(CRect& rect) const;

Parámetros

[in] rect

Valor devuelto

Comentarios

CMFCRibbonStatusBar::GetSpace

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.

int GetSpace() const;

Valor devuelto

Comentarios

CMFCRibbonStatusBar::IsBottomFrame

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.

BOOL IsBottomFrame() const;

Valor devuelto

Comentarios

CMFCRibbonStatusBar::IsExtendedElement

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.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

Parámetros

[in] pElement

Valor devuelto

Comentarios

CMFCRibbonStatusBar::IsInformationMode

Determina si el modo de información está habilitado para la barra de estado de la cinta de opciones.

BOOL IsInformationMode() const;

Valor devuelto

Es TRUE si la barra de estado puede funcionar en modo de información; de lo contrario, es FALSE.

Comentarios

En el modo de información, la barra de estado oculta todos los paneles normales y muestra una cadena de mensaje.

CMFCRibbonStatusBar::OnDrawInformation

Muestra la cadena que aparece en la barra de estado de la cinta de opciones cuando el modo de información está habilitado.

virtual void OnDrawInformation(
    CDC* pDC,
    CString& strInfo,
    CRect rectInfo);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

strInfo
[in] Cadena de información.

rectInfo
[in] Rectángulo delimitador.

Comentarios

Invalide este método en una clase derivada si quiere personalizar la apariencia de la cadena de información en la barra de estado. Use el método CMFCRibbonStatusBar::SetInformation para poner la barra de estado en modo de información. En este modo, la barra de estado oculta todos los paneles y muestra la cadena de información que especifica strInfo.

CMFCRibbonStatusBar::RecalcLayout

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 RecalcLayout();

Comentarios

CMFCRibbonStatusBar::RemoveAll

Quita todos los elementos de la barra de estado de la cinta de opciones.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

Quita el elemento que tiene un id. de comando especificado de la barra de estado de la cinta de opciones.

BOOL RemoveElement(UINT uiID);

Parámetros

uiID
[in] Id. del elemento que se va a quitar de la barra de estado.

Valor devuelto

TRUE si se quita un elemento con el uiID especificado. FALSE en caso contrario.

CMFCRibbonStatusBar::SetInformation

Habilita o deshabilita el modo de información de la barra de estado de la cinta de opciones.

void SetInformation(LPCTSTR lpszInfo);

Parámetros

lpszInfo
[in] Cadena de información.

Comentarios

Use este método para colocar la barra de estado en modo de información. En este modo, la barra de estado oculta todos los paneles y muestra la cadena de información que especifica lpszInfo.

Cuando lpszInfo es NULL, la barra de estado vuelve al modo normal.

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonBar (clase)
CMFCRibbonBaseElement (clase)
CMFCRibbonBar (clase)