CProgressCtrl::GetState
現在の進行状況バー コントロールの状態を取得します。
int GetState() const;
戻り値
次の値の 1 ですが、現在の進行状況バー コントロールの状態、:
値 |
状態 |
|---|---|
PBST_NORMAL |
処理中 |
PBST_ERROR |
エラー |
PBST_PAUSED |
Paused |
解説
このメソッドはWindows SDKで説明する PBM_GETSTATE のメッセージを送信します。
必要条件
ヘッダー: 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);