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 | 最小値と最大値を設定します。 |
解説
CMFCRibbonProgressBarは、通常モードと無限モードの 2 つのモードで動作できます。 通常モードでは、進行状況バーは左から右に塗りつぶされ、最大値に達すると停止します。 無限モードでは、進行状況バーは最小値から最大値まで繰り返し入力されます。 無限モードを使用して、操作が進行中であるが、完了時間が不明であることを示すことができます。
例
CMFCRibbonProgressBar クラスのさまざまなメソッドの使用方法を次の例に示します。 この例では、進行状況バーを無限モードで動作するように設定し (操作の完了時間が不明な場合)、進行状況バーの最小値と最大値を設定し、進行状況バーの現在位置を設定する方法を示します。 このコード スニペットは、 MS Office 2007 Demo サンプルの一部です。
// 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);
継承階層
要件
Header: 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);
パラメーター
[入力] pDC
戻り値
解説
CMFCRibbonProgressBar::IsInfiniteMode
進行状況バーが無限モードで動作するかどうかを指定します。
BOOL IsInfiniteMode() const;
戻り値
進行状況バーが無限モードの場合は TRUE。それ以外の場合は FALSE。
解説
無限モードでは、進行状況バーは最小値から最大値まで繰り返し塗りつぶされます。 無限モードを使用して、操作が進行中であるが、完了時間が不明であることを示すことができます。
CMFCRibbonProgressBar::OnDraw
詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。
virtual void OnDraw(CDC* pDC);
パラメーター
[入力] pDC
解説
CMFCRibbonProgressBar::SetInfiniteMode
進行状況バーを無限モードで動作するように設定します。
void SetInfiniteMode(BOOL bSet = TRUE);
パラメーター
bSet
[in]進行状況バーが無限モードであることを指定する場合は TRUE。それ以外の場合は FALSE。
解説
通常、進行状況バーが無限モードの場合、操作は進行中ですが、完了時間は不明であることをユーザーに伝えます。 したがって、進行状況バーは最小値から最大値まで繰り返し塗りつぶされます。
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]範囲の最大値を指定します。
解説
このメソッドを使用して、最小値と最大値を設定して進行状況バーの範囲を定義します。