CProgressCtrl::SetState
現在の進行状況バー コントロールの状態を設定します。
int SetState(
int iState
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力] iState |
プログレス バーの状態を設定します。次のいずれかの値を使用します。
値状態
PBST_NORMAL 処理中
PBST_ERROR エラー
PBST_PAUSED Paused
|
戻り値
現在の進行状況バー コントロールの前の状態。
解説
このメソッドは Windows SDKで説明する PBM_SETSTATE のメッセージを送信します。
必要条件
ヘッダー: afxcmn.h
このコントロールは Windows Vista 以降でサポートされます。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例では、プログラムで進行状況バー コントロールへのアクセスに使用される変数、m_progressCtrlを定義します。この変数は次のように使用されます。
// Variable to access the progress control
CProgressCtrl m_progressCtrl;
次のコード例は、現在の進行状況バー コントロールの状態と進行中、一時停止に設定します。
// Set the progrees control to normal or paused state.
void CCProgressCtrl_s1Dlg::OnSetstateNormal()
{
m_progressCtrl.SetState(PBST_NORMAL);
}
void CCProgressCtrl_s1Dlg::OnSetstatePaused()
{
m_progressCtrl.SetState(PBST_PAUSED);
}