CMFCStatusBar 類別

發行項
02/28/2013

CMFCStatusBar 類別實作一個狀態列類似 CStatusBar 類別。不過， CMFCStatusBar 類別具有 CStatusBar 類別所提供的功能，例如能夠顯示影像、動畫和進度列，而且也可以回應滑鼠按兩下。

class CMFCStatusBar : public CPane

Members

公用方法

名稱	描述
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 物件。 (覆寫 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 影像

範例

下列範例會示範應用程式使用的使用者 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;

下列範例示範如何藉由引入 GetStatusBar 方法在 MainFrm.h 然後呼叫這個方法取得 CMFCStatusBar 物件的參考。 GetStatusBar 方法在 StatusBarDemoView.h。這個程式碼片段是狀態列示範範例的一部分。

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


...


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

下列範例示範如何呼叫 CMFCStatusBar 類別的各種方法在 StatusBarDemoView.cpp。在 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);