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

参照

関連項目

PBM_GETSTATE