CProgressCtrl::GetState
更新 : 2007 年 11 月
現在のプログレス バー コントロールの状態を取得します。
int GetState() const;
戻り値
現在のプログレス バー コントロールの状態。以下のいずれかの値になります。
値 |
状態 |
|---|---|
PBST_NORMAL |
処理中 |
PBST_ERROR |
エラー |
PBST_PAUSED |
一時停止 |
解説
このメソッドは、PBM_GETSTATE メッセージを送信します。このメッセージについては、Windows SDK を参照してください。
必要条件
ヘッダー : afxcmn.h
このコントロールは、Windows Vista およびそれ以降のバージョンでサポートされています。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例では、プログラムによってプログレス バー コントロールにアクセスするために使用される m_progressCtrl 変数を定義しています。この変数は、次の例で使用されます。
// Variable to access the progress control
CProgressCtrl m_progressCtrl;
次のコード例では、現在のプログレス バー コントロールの状態を取得します。
// Display the current state of the progress control.
CString str = _T("The progress control state is ");
int progState = m_progressCtrl.GetState();
if (progState == PBST_NORMAL)
str += _T("NORMAL");
else if (progState == PBST_PAUSED)
str += _T("PAUSED");
else if (progState == PBST_ERROR)
str += _T("ERROR");
else
str += _T("unknown");
AfxMessageBox(str, MB_ICONEXCLAMATION);