CMFCStatusBar クラス

[アーティクル]
08/09/2011

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 のウィンドウが作成される前に、フレームワークから呼び出されます。 (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	ステータスバーにペインを再描画するときにフレームワークによって呼び出されます。

解説

StatusBarDemo サンプル:ステータスバーの MFC アプリケーションアプリケーションのステータスバーを次の図に示します。

CMFCStatusBar イメージ

使用例

CMFCStatusBar クラスでさまざまなメソッドを呼び出すためにアプリケーションが使用するローカル変数を次の例に示します。これらの変数は、StatusBarDemoView.h で宣言されています。メインフレームは MainFrm.h で宣言され、ドキュメントは StatusBarDemoDoc.h で宣言され、ビューは StatusBarDemoView.h で宣言されています。このコードスニペットは、「StatusBarDemo サンプル:ステータスバーの MFC アプリケーション」の一部です。

    int         m_nProgressCurr;
    BOOL        m_bInProgress;

    CImageList  m_imlStatusAnimation;
    BOOL        m_bInAnimation;

    CBitmap     m_bmpIcon1;
    CBitmap     m_bmpIcon2;

MainFrm.h に GetStatusBar メソッドを導入し、このメソッドを StatusBarDemoView.h の GetStatusBar メソッドから呼び出すことによって、CMFCStatusBar オブジェクトへの参照を取得する方法を次の例に示します。このコードスニペットは、「StatusBarDemo サンプル:ステータスバーの MFC アプリケーション」の一部です。

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


...


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

StatusBarDemoView.cpp の CMFCStatusBar クラスでさまざまなメソッドを呼び出す方法を次の例に示します。定数は MainFrm.h で宣言されます。この例では、アイコンを設定し、ステータスバーペインのツールヒントテキストを設定し、指定されたペインにプログレスバーを表示し、指定されたペインにアニメーションを割り当て、ステータスバーペインのテキストと幅を設定し、ステータスバーペインにプログレスバーの現在のプログレスインジケーターを設定する方法を示します。このコードスニペットは、「StatusBarDemo サンプル:ステータスバーの 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);