CMFCRibbonProgressBar クラス

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

構文

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	最小値と最大値を設定します。

解説

A CMFCRibbonProgressBar は、通常モードと無限モードの 2 つのモードで動作できます。 通常モードでは、進行状況バーは左から右に塗りつぶされ、最大値に達すると停止します。 無限モードでは、進行状況バーは最小値から最大値まで繰り返し入力されます。 無限モードを使用して、操作が進行中であるが、完了時間が不明であることを示すことができます。

例

CMFCRibbonProgressBar クラスのさまざまなメソッドの使用方法を次の例に示します。 この例では、進行状況バーを無限モードで動作するように設定し (操作の完了時間が不明な場合)、進行状況バーの最小値と最大値を設定し、進行状況バーの現在位置を設定する方法を示します。 このコード スニペットは、MS Office 2007 デモ サンプルの一部です。

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

継承階層

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

必要条件

ヘッダー: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

CMFCRibbonProgressBar オブジェクトを構築して初期化します。

CMFCRibbonProgressBar();

CMFCRibbonProgressBar(
    UINT nID,
    int nWidth = 90,
    int nHeight = 22);

パラメーター

nID
[in]リボンの進行状況バーのコマンド ID を指定します。

nWidth
[in]リボンの進行状況バーの幅をピクセル単位で指定します。

nHeight
[in]リボンの進行状況バーの高さをピクセル単位で指定します。

CMFCRibbonProgressBar::GetPos

進行状況バーの現在位置を返します。

int GetPos () const;

戻り値

進行状況バーの現在位置を表す値。

解説

設定する範囲は、CMFCRibbonProgressBar::SetRange メソッドで指定された範囲内である必要があります。

CMFCRibbonProgressBar::GetRangeMax

進行状況バーの現在の最大値を返します。

int GetRangeMax() const;

戻り値

現在の範囲の最大値。

解説

CMFCRibbonProgressBar::GetRangeMin

進行状況バーの現在の最小値を返します。

int GetRangeMin() const;

戻り値

現在の範囲の最小値。

CMFCRibbonProgressBar::GetRegularSize

詳細については、Visual Studio インストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。

virtual CSize GetRegularSize(CDC* pDC);

パラメーター

[in] Pdc

戻り値

解説

CMFCRibbonProgressBar::IsInfiniteMode

進行状況バーが無限モードで動作するかどうかを指定します。

BOOL IsInfiniteMode() const;

戻り値

進行状況バーが無限モードの場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

無限モードでは、進行状況バーは最小値から最大値まで繰り返し塗りつぶされます。 無限モードを使用して、操作が進行中であるが、完了時間が不明であることを示すことができます。

CMFCRibbonProgressBar::OnDraw

詳細については、Visual Studio インストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。

virtual void OnDraw(CDC* pDC);

パラメーター

[in] Pdc

解説

CMFCRibbonProgressBar::SetInfiniteMode

進行状況バーを無限モードで動作するように設定します。

void SetInfiniteMode(BOOL bSet = TRUE);

パラメーター

bSet
[in]進行状況バーが無限モードであることを指定する場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

通常、進行状況バーが無限モードの場合、操作は進行中ですが、完了時間は不明であることをユーザーに伝えます。 したがって、進行状況バーは最小値から最大値まで繰り返し塗りつぶされます。

CMFCRibbonProgressBar::SetPos

進行状況バーの現在位置を設定します。

void SetPos(
    int nPos,
    BOOL bRedraw = TRUE);

パラメーター

nPos
[in]進行状況バーを設定する位置を指定します。

bRedraw
[in]進行状況バーを再描画するかどうかを指定します。

解説

設定する範囲は、CMFCRibbonProgressBar::SetRange メソッドで指定された範囲内である必要があります。

CMFCRibbonProgressBar::SetRange

進行状況バーの最小値と最大値を設定します。

void SetRange(
    int nMin,
    int nMax);

パラメーター

nMin
[in]範囲の最小値を指定します。

nMax
[in]範囲の最大値を指定します。

解説

このメソッドを使用して、最小値と最大値を設定して進行状況バーの範囲を定義します。

関連項目

階層図
クラス
CMFCRibbonBaseElement クラス
CMFCRibbonBar クラス