Classe CMFCStatusBar

Artigo
08/25/2010

The CMFCStatusBar classe implementa uma BAR de status similar do CStatusBar classe. No entanto, a CMFCStatusBar classe possui recursos não oferecidos pela CStatusBar classe, sistema autônomo a capacidade de exibir imagens, animações e sistema autônomo barras de progresso e a capacidade de responder ao mouse clica duas vezes.

class CMFCStatusBar : public CPane

Membros

Métodos públicos

Nome	Descrição
CMFCStatusBar::CalcFixedLayout	(Substitui CBasePane::CalcFixedLayout.)
CMFCStatusBar::CommandToIndex
CMFCStatusBar::criar	Cria uma BAR de controle e a anexa à CPane objeto.(Substitui CPane::criar.)
CMFCStatusBar::CreateEx	Cria uma BAR de controle e a anexa à CPane objeto.(Substitui CPane::CreateEx.)
CMFCStatusBar::DoesAllowDynInsertBefore	Determina se outro painel pode ser inserido dinamicamente entre esse painel e o quadro pai.(Substitui CBasePane::DoesAllowDynInsertBefore.)
CMFCStatusBar::EnablePaneDoubleClick	Ativa ou desativa o tratamento de mouse clica duas vezes na BAR de status.
CMFCStatusBar::EnablePaneProgressBar	Exibe um BAR de progresso no painel especificado.
CMFCStatusBar::GetCount	Retorna o número de painéis na BAR de status.
CMFCStatusBar::GetDrawExtendedArea
CMFCStatusBar::GetExtendedArea
CMFCStatusBar::GetItemID
CMFCStatusBar::GetItemRect
CMFCStatusBar::GetPaneInfo
CMFCStatusBar::GetPaneProgress
CMFCStatusBar::GetPaneStyle	Retorna o estilo de painel.(Substitui CBasePane::GetPaneStyle.)
CMFCStatusBar::GetPaneText
CMFCStatusBar::GetPaneWidth	Retorna a largura, em pixels, do painel especificado do BAR de status.
CMFCStatusBar::GetTipText	Retorna o texto da dica de ferramenta para o painel especificado do BAR de status.
CMFCStatusBar::InvalidatePaneContent	Invalida o painel especificado e redesenha o seu conteúdo.
CMFCStatusBar::PreCreateWindow	Chamado pelo estrutura antes da criação da janela do Windows anexada a este CWnd objeto. (Substitui CWnd::PreCreateWindow.)
CMFCStatusBar::SetDrawExtendedArea
CMFCStatusBar::SetIndicators
CMFCStatusBar::SetPaneAnimation	Atribui uma animação para o painel especificado.
CMFCStatusBar::SetPaneBackgroundColor	Define a cor do plano de fundo para o painel especificado do BAR de status.
CMFCStatusBar::SetPaneIcon	Define o ícone de indicador para o painel especificado do BAR de status.
CMFCStatusBar::SetPaneInfo
CMFCStatusBar::SetPaneProgress	Define o progresso corrente da BAR de progresso para o painel especificado do BAR de status.
CMFCStatusBar::SetPaneStyle	Define o estilo do painel.(Substitui CBasePane::SetPaneStyle.)
CMFCStatusBar::SetPaneText
CMFCStatusBar::SetPaneTextColor	Define a cor do texto para o painel especificado do BAR de status.
CMFCStatusBar::SetPaneWidth	Define a largura em pixels do painel especificado do BAR de status.
CMFCStatusBar::SetTipText	Define o texto de dica de ferramenta para o painel especificado do BAR de status.

Métodos protegidos

Nome	Descrição
CMFCStatusBar::OnDrawPane	Chamado pela estrutura quando ele redesenha o painel do BAR de status.

Comentários

O diagrama a seguir mostra a figura da BAR de status de Exemplo do StatusBarDemo: BAR de status Aplicativo MFC aplicativo.

Exemplo

O exemplo a seguir demonstra as variáveis de locais, que utiliza o aplicativo para chamar vários métodos no CMFCStatusBar classe. Essas variáveis são declaradas em StatusBarDemoView.h.O quadro principal é declarado em MainFrm.h, o documento for declarado em StatusBarDemoDoc.h e o modo de exibição é declarado em StatusBarDemoView.h.Neste trecho de código faz parte o Exemplo do StatusBarDemo: BAR de status Aplicativo MFC.

   int         m_nProgressCurr;
    BOOL        m_bInProgress;

    CImageList  m_imlStatusAnimation;
    BOOL        m_bInAnimation;

    CBitmap     m_bmpIcon1;
    CBitmap     m_bmpIcon2;

O exemplo a seguir demonstra como obter uma referência a CMFCStatusBar objeto introduzindo o GetStatusBar método em MainFrm.h e depois chamar esse método a partir do GetStatusBar método no StatusBarDemoView.h. Neste trecho de código faz parte o Exemplo do StatusBarDemo: BAR de status Aplicativo MFC.

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


...


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

O exemplo a seguir demonstra como chamar diversos métodos no CMFCStatusBar classe no StatusBarDemoView.cpp. As constantes são declaradas no MainFrm.h.O exemplo mostra como conjunto o ícone, conjunto o texto de dica de ferramenta do painel de BAR de status, exibir uma BAR de progresso no painel especificado, atribuir uma animação para o painel especificado, conjunto o texto e a largura do painel da BAR de status e defina o indicador de progresso corrente da BAR de progresso para o painel de BAR de status.Neste trecho de código faz parte o Exemplo do StatusBarDemo: BAR de status Aplicativo MFC.

// 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);