CMFCStatusBar Class （MFC状态栏类）

CMFCStatusBar Class （MFC状态栏类）

CMFCStatusBar Class

Visual Studio 2010

CMFCStatusBar类实现类似CStatusBar类那样的状态栏。尽管，CMFCStatusBar类拥有CStatusBar类中没有的功能，能够显示图像，动画和进度条等；响应鼠标双击事件。

class  CMFCStatusBar :  public  CPane

成员
公共方法

CMFCStatusBar::CalcFixedLayout	( 重载 CBasePane::CalcFixedLayout.)
CMFCStatusBar::CommandToIndex
CMFCStatusBar::Create	创建一个控件栏附在CPane 对象上. (重载 CPane::Create.)
CMFCStatusBar::CreateEx	创建一个控件栏附在 CPane 对象上. (重载 CPane::CreateEx.)
CMFCStatusBar::DoesAllowDynInsertBefore	决定再这个窗格和父窗格之间是否可以动态插入另外的窗格。 (重载 CBasePane::DoesAllowDynInsertBefore.)
CMFCStatusBar::EnablePaneDoubleClick	启用或者禁用状态栏上鼠标双击操作。
CMFCStatusBar::EnablePaneProgressBar	在指定的窗格上显示进度条。
CMFCStatusBar::GetCount	返回状态栏上的窗格数量。
CMFCStatusBar::GetDrawExtendedArea
CMFCStatusBar::GetExtendedArea
CMFCStatusBar::GetItemID
CMFCStatusBar::GetItemRect
CMFCStatusBar::GetPaneInfo
CMFCStatusBar::GetPaneProgress
CMFCStatusBar::GetPaneStyle	返回窗格样式。 (重载CBasePane::GetPaneStyle.)
CMFCStatusBar::GetPaneText
CMFCStatusBar::GetPaneWidth	返回指定状态栏窗格的宽带（像素）.
CMFCStatusBar::GetTipText	返回指定状态栏窗格的工具提示文本。
CMFCStatusBar::InvalidatePaneContent	指定窗格失效，重绘其内容.
CMFCStatusBar::PreCreateWindow	在创建连接到CWnd对象的Windows窗口之前被framework调用。(重载 CWnd::PreCreateWindow.)
CMFCStatusBar::SetDrawExtendedArea
CMFCStatusBar::SetIndicators
CMFCStatusBar::SetPaneAnimation	分配动画到指定窗格。
CMFCStatusBar::SetPaneBackgroundColor	为指定状态栏窗格设置背景颜色
CMFCStatusBar::SetPaneIcon	为指定状态栏窗格设置指示图标。
CMFCStatusBar::SetPaneInfo
CMFCStatusBar::SetPaneProgress	为指定状态栏窗格设置进度条的当前进度。
CMFCStatusBar::SetPaneStyle	设置窗格样式。 (重载 CBasePane::SetPaneStyle.)
CMFCStatusBar::SetPaneText
CMFCStatusBar::SetPaneTextColor	设置指定状态栏窗格文本颜色。
CMFCStatusBar::SetPaneWidth	设置指定状态栏窗格宽度（像素）。
CMFCStatusBar::SetTipText	设置指定状态栏窗格工具提示文本。

受保护的方法
名称                                                  描述

CMFCStatusBar::OnDrawPane              当重绘状态栏窗格时，由框架调用。

备注
下图展示了一个图像状态栏的 状态栏演示示例 应用程序。


例子
下面的示例演示该应用程序在CMFCStatusBar类中调用各种方法使用局部变量。变量定义在StatusBarDemoView.h中。主框架定义在MainFrm.h中，文件定义在StatusBarDemoDoc.h中，视图定义在StatusBarDemoView.h。这个代码片段是 状态栏演示示例 的一部分。

int             m_nProgressCurr;
    BOOL        m_bInProgress;

    CImageList    m_imlStatusAnimation;
    BOOL        m_bInAnimation;

    CBitmap        m_bmpIcon1;
    CBitmap        m_bmpIcon2;

下面的示例演示怎样在MainFrm.h中通过介绍GetStatusBar方法来得到CMFCStatusBar对象引用，然后在StatusBarDemoView.h中从GetStatusBar方法调用这个方法。这个代码片段是 状态栏演示示例 的一部分。

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





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

下面的示例演示StatusBarDemoView.cpp中的CMFCStatusBar类调用各种方法。在MainFrm.h中申明常量。这个例子显示如何设置图标，设置状态栏窗格的提示文本，在指定窗格显示一个进度条，分配一个动画到指定窗格，设置状态栏窗格的文本和宽度，并为指示器状态栏窗格设置进度条的当前进度。这个代码是 状态栏演示示例 的一部分。

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

继承层次结构

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCStatusBar

要求
头文件： afxstatusbar.h

参见
引用

Hierarchy Chart

CPane Class

CStatusBar Class

其他资源

MFC Classes

原文： http://msdn.microsoft.com/zh-cn/library/bb984575.aspx