CMFCRibbonProgressBar クラス

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

時間のかかる操作の進行状況を視覚的に示すコントロールを実装します。

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

メンバー

パブリックコンストラクター

[名前]	説明
CMFCRibbonProgressBar::CMFCRibbonProgressBar	CMFCRibbonProgressBar オブジェクトを構築し、初期化します。

パブリックメソッド

[名前]	説明
CMFCRibbonProgressBar::GetPos	現在の進行状況を返します。
CMFCRibbonProgressBar::GetRangeMax	現在の範囲の最大値を返します。
CMFCRibbonProgressBar::GetRangeMin	現在の範囲の最小値を返します。
CMFCRibbonProgressBar::GetRegularSize	リボン要素の標準サイズを返します。 (CMFCRibbonBaseElement::GetRegularSize をオーバーライドします。)
CMFCRibbonProgressBar::IsInfiniteMode	プログレスバーが無限モードで動作しているかどうかを指定します。
CMFCRibbonProgressBar::OnDraw	リボン要素を描画するために、フレームワークによって呼び出されます。 (CMFCRibbonBaseElement::OnDraw をオーバーライドします。)
CMFCRibbonProgressBar::SetInfiniteMode	プログレスバーが無限モードで動作するように設定します。
CMFCRibbonProgressBar::SetPos	現在の進行状況を設定します。
CMFCRibbonProgressBar::SetRange	最小値および最大値を設定します。

解説

ACMFCRibbonProgressBar2 つのモードで動作することができます。通常、無限。通常モードでは、プログレスバーが左から右に塗りつぶされ、最大値に達すると停止します。無限モードでは、プログレスバーが最小値から最大値まで繰り返し、塗りつぶされます。無限モードを使用すると、操作が進行中で、完了までの時間は不明であることを指定できます。

使用例

CMFCRibbonProgressBar クラスのさまざまなメソッドの使用方法を次の例に示します。この例では、無限モードで動作するようプログレスバーを設定する方法 (処理の完了時間が不明な場合)、プログレスバーの最小値と最大値を設定する方法、およびプログレスバーの現在の位置を設定する方法を示しています。このコードスニペットは、「MSOffice2007Demo サンプル:MFC の Office アプリケーション」の一部です。

        // int cxProgress
        // BOOL m_bInfiniteProgressMode
        CMFCRibbonProgressBar* pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);

        pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
        pProgressBar->SetRange(0,200);
        pProgressBar->SetPos(200,true);