Clase de CMFCStatusBar

Artículo
04/10/2013

la clase de CMFCStatusBar implementa una barra de estado similar a la clase de CStatusBar .Sin embargo, la clase de CMFCStatusBar tiene características no proporcionadas por la clase de CStatusBar , como la capacidad para mostrar imágenes, a las animaciones, y las barras de progreso; y la capacidad de responder a los doble clic del mouse.

class CMFCStatusBar : public CPane

Members

Métodos públicos

Name	Descripción
CMFCStatusBar::CalcFixedLayout	(Reemplaza CBasePane::CalcFixedLayout.)
CMFCStatusBar::CommandToIndex
CMFCStatusBar::Create	Crea una barra de controles y la agrega al objeto de CPane .(Reemplaza CPane::Create.)
CMFCStatusBar::CreateEx	Crea una barra de controles y la agrega al objeto de CPane .(Reemplaza CPane::CreateEx.)
CMFCStatusBar::DoesAllowDynInsertBefore	determina si otro panel se puede insertar dinámicamente entre este panel y el cuadro primario.(Reemplaza CBasePane::DoesAllowDynInsertBefore.)
CMFCStatusBar::EnablePaneDoubleClick	Habilita o deshabilita la administración de los doble clic del mouse en la barra de estado.
CMFCStatusBar::EnablePaneProgressBar	Muestra una barra de progreso en el panel especificado.
CMFCStatusBar::GetCount	Devuelve el número de paneles de la barra de estado.
CMFCStatusBar::GetDrawExtendedArea
CMFCStatusBar::GetExtendedArea
CMFCStatusBar::GetItemID
CMFCStatusBar::GetItemRect
CMFCStatusBar::GetPaneInfo
CMFCStatusBar::GetPaneProgress
CMFCStatusBar::GetPaneStyle	Devuelve el estilo del panel.(Reemplaza CBasePane::GetPaneStyle.)
CMFCStatusBar::GetPaneText
CMFCStatusBar::GetPaneWidth	Devuelve el ancho, en píxeles, del panel especificado de la barra de estado.
CMFCStatusBar::GetTipText	Devuelve el texto de información sobre herramientas para el panel especificado de la barra de estado.
CMFCStatusBar::InvalidatePaneContent	Reemplaza el panel especificado y volverá a su contenido.
CMFCStatusBar::PreCreateWindow	Llamado por el marco antes de la creación de la ventana de Windows asociada a este objeto de CWnd .(Reemplaza CWnd::PreCreateWindow.)
CMFCStatusBar::SetDrawExtendedArea
CMFCStatusBar::SetIndicators
CMFCStatusBar::SetPaneAnimation	Asigna una animación el panel especificado.
CMFCStatusBar::SetPaneBackgroundColor	Establece el color de fondo del panel especificado de la barra de estado.
CMFCStatusBar::SetPaneIcon	Establece el icono de marcador para el panel especificado de la barra de estado.
CMFCStatusBar::SetPaneInfo
CMFCStatusBar::SetPaneProgress	establece el progreso actual de la barra de progreso para el panel especificado de la barra de estado.
CMFCStatusBar::SetPaneStyle	Establece el estilo del panel.(Reemplaza CBasePane::SetPaneStyle.)
CMFCStatusBar::SetPaneText
CMFCStatusBar::SetPaneTextColor	Establece el color del texto al panel especificado de la barra de estado.
CMFCStatusBar::SetPaneWidth	Establece el ancho en píxeles del panel especificado de la barra de estado.
CMFCStatusBar::SetTipText	Establece el texto de información sobre herramientas para el panel especificado de la barra de estado.

Métodos protegidos

Name	Descripción
CMFCStatusBar::OnDrawPane	Llamado por el marco cuando dibuja de nuevo el panel de barra de estado.

Comentarios

El diagrama siguiente se muestra una ilustración de la barra de estado de la aplicación de Ejemplo de demostración de la barra de estado .

Imagen de CMFCStatusBar

Ejemplo

El ejemplo siguiente muestra las variables locales que la aplicación utiliza para llamar a los distintos métodos en la clase de CMFCStatusBar .estas variables se declaran en StatusBarDemoView.h.El marco principal se declara en MainFrm.h, el documento se declara en StatusBarDemoDoc.h, y la vista se declara en StatusBarDemoView.h.Este fragmento de código es parte de Ejemplo de demostración de la barra de estado.

    int         m_nProgressCurr;
    BOOL        m_bInProgress;

    CImageList  m_imlStatusAnimation;
    BOOL        m_bInAnimation;

    CBitmap     m_bmpIcon1;
    CBitmap     m_bmpIcon2;

El ejemplo siguiente muestra cómo obtener una referencia al objeto de CMFCStatusBar mediante el método de GetStatusBar en MainFrm.h y después llamar a este método del método de GetStatusBar en StatusBarDemoView.h.Este fragmento de código es parte de Ejemplo de demostración de la barra de estado.

// in MainFrm.h
public:
    CMFCStatusBar& GetStatusBar ()
    {
        return m_wndStatusBar;
    }


...


    // in StatusBarDemoView.h
    CMFCStatusBar& GetStatusBar () const
    {
        return ((CMainFrame*) AfxGetMainWnd ())->GetStatusBar ();
    }

El ejemplo siguiente se muestra cómo llamar a varios métodos en la clase de CMFCStatusBar en StatusBarDemoView.cpp.las constantes se declaran en MainFrm.h.El ejemplo muestra cómo establecer el icono, establece el texto de información sobre herramientas del panel de barra de estado, muestra una barra de progreso en el panel especificado, asigne una animación el panel especificado, establece el texto y el ancho del panel de barra de estado, y establece el indicador de progreso actual de la barra de progreso para el panel de barra de estado.Este fragmento de código es parte de Ejemplo de demostración de la barra de estado.

// in MainFrm.h
const int nStatusIcon = 0;
const int nStatusInfo = 1;
const int nStatusProgress = 2;
const int nStatusLabel = 3;
const int nStatusAnimation = 4;


...


    // in StatusBarDemoView.cpp
    GetStatusBar ().SetPaneIcon (nStatusIcon, m_bmpIcon1);
    GetStatusBar ().SetTipText (nStatusIcon, _T("This is a tooltip"));


...


    GetStatusBar ().EnablePaneProgressBar (nStatusProgress, PROGRESS_MAX);


...


        GetStatusBar ().SetPaneAnimation (nStatusAnimation, NULL);


...


    GetStatusBar ().SetPaneAnimation (nStatusAnimation, m_imlStatusAnimation);
    GetStatusBar ().SetPaneText (nStatusAnimation, _T(""));
    GetStatusBar ().SetPaneWidth (nStatusAnimation, 16);


...


        GetStatusBar ().SetPaneProgress (nStatusProgress, m_nProgressCurr);