Clase de CStatusBar

Artículo
04/10/2013

Una barra de controles con una fila de texto generado los paneles, o “marcadores”.

class CStatusBar : public CControlBar

Miembros

Constructores públicos

Name	Descripción
CStatusBar::CStatusBar	Crea un objeto CStatusBar.

Métodos públicos

Name	Descripción
CStatusBar::CommandToIndex	Obtiene el índice de una identificación especificada de marcador
CStatusBar::Create	Crea la barra de estado, la asocia el objeto de CStatusBar , y establece la fuente y el alto de barras iniciales.
CStatusBar::CreateEx	Crea un objeto de CStatusBar con estilos adicionales para el objeto incrustado de CStatusBarCtrl .
CStatusBar::DrawItem	Llamado cuando un aspecto visual de los cambios de dibujo del propietario de un control de barra de estado.
CStatusBar::GetItemID	Obtiene el identificador de marcador para un índice especificado.
CStatusBar::GetItemRect	Obtiene el rectángulo de presentación para un índice especificado.
CStatusBar::GetPaneInfo	Obtiene el identificador, el estilo, y el ancho de marcador para un índice especificado.
CStatusBar::GetPaneStyle	Obtiene el estilo de marcador para un índice especificado.
CStatusBar::GetPaneText	Obtiene el texto de marcador para un índice especificado.
CStatusBar::GetStatusBarCtrl	Permite el acceso directo al control común subyacente.
CStatusBar::SetIndicators	Establece id. de marcador.
CStatusBar::SetPaneInfo	Establece el identificador, el estilo, y el ancho de marcador para un índice especificado.
CStatusBar::SetPaneStyle	Establece el estilo de marcador para un índice especificado.
CStatusBar::SetPaneText	Establece el texto de marcador para un índice especificado.

Comentarios

Los paneles de resultados se utilizan normalmente como líneas de mensajes como indicadores de estado.Los ejemplos incluyen las líneas de AYUDA-mensaje de menú que explican brevemente el comando de menú seleccionado y los indicadores que muestran el estado de BLOQ DESPL, de BLOQ NUM, y otras claves.

CStatusBar:: GetStatusBarCtrl, una función miembro nueva a MFC 4,0, permite aprovechar las ventajas de la compatibilidad de controles comunes de Windows para la personalización y la funcionalidad adicional de la barra de estado.las funciones miembro deCStatusBar ofrecen la mayor parte de la funcionalidad de los controles comunes de Windows; sin embargo, cuando se llama a GetStatusBarCtrl, puede proporcionar a barras de estado aun más de las características de Windows 95 /98 barra de estado.Cuando se llama a GetStatusBarCtrl, devolverá una referencia a un objeto de CStatusBarCtrl .Vea CStatusBarCtrl para obtener más información sobre el diseño de las barras de herramientas mediante controles comunes de Windows.Para obtener más información general sobre los controles comunes, vea Controles comunes en Windows SDK.

El marco almacena información de marca de una matriz con el marcador de izquierda en la posición 0.Cuando se crea una barra de estado, se utiliza una matriz de los id. de la cadena que el marco asocia los marcadores correspondientes.Puede utilizar un identificador de cadena o un índice para tener acceso a una solicitud.

de forma predeterminada, el primer indicador es “elástico”: toma la longitud de la barra de estado no usa en otros paneles de marcador, de modo que los otros paneles estén alineadas a la derecha.

para crear una barra de estado, siga estos pasos:

Cree el objeto de CStatusBar .
Llame a la función de Crear (o CreateEx) para crear la ventana de la barra de estado y para adjuntarla al objeto de CStatusBar .
Llame a SetIndicators para asociar un identificador de cadena con cada marcador.

Hay tres maneras de actualizar el texto de un panel de barra de estado:

Llamada CWnd:: SetWindowText para actualizar el texto del panel 0 únicamente.
Llamada CCmdUI:: SetText en el controlador de ON_UPDATE_COMMAND_UI de barra de estado.
Llame a SetPaneText para actualizar el texto para cualquier panel.

Llame a SetPaneStyle para actualizar el estilo de un panel de barra de estado.

Para obtener más información sobre cómo utilizar CStatusBar, vea el artículo implementación de la barra de estado en MFC y nota técnica 31: Barras de controles.