CProgressCtrl::SetState
更新 : 2007 年 11 月
現在のプログレス バー コントロールの状態を設定します。
int SetState(
int iState
);
パラメータ
パラメータ |
説明 |
|---|---|
[入力] iState |
プログレス バーに設定する状態。次のいずれかの値を使用します。
値状態
PBST_NORMAL 処理中
PBST_ERROR エラー
PBST_PAUSED 一時停止
|
戻り値
現在のプログレス バー コントロールの以前の状態。
解説
このメソッドは、PBM_SETSTATE メッセージを送信します。このメッセージについては、Windows SDK を参照してください。
必要条件
ヘッダー : 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);
}