CTaskDialog::SetProgressBarState

项目
03/01/2013

设置进度栏的状态并将其显示在 CTaskDialog。

void SetProgressBarState(
   int nState = PBST_NORMAL
);

参数

[in] nState
进度栏的状态。为可能的值参见"备注"节。

备注

此方法将引发与确保(MFC) 宏中引发异常，如果 CTaskDialog 已突出显示并具有marquee进度栏。

下表列出了 nState的可能值。在以上所有情况下，进度栏将以常规颜色将加载，直到其达到指定的表位位置。此时它将更改基于该状态的颜色。

PBST_NORMAL
在进度栏加载后，CTaskDialog 不会更改该线条的颜色。默认情况下，normal颜色为绿色。
PBST_ERROR
在进度栏加载后，CTaskDialog 更改该线条的颜色改为错误颜色。默认情况下，为红色。
PBST_PAUSED
在进度栏加载后，CTaskDialog 更改该线条的颜色为暂停的颜色。默认情况下，为黄色的。

可以设置进度栏停止点与 CTaskDialog::SetProgressBarPosition的位置。

示例

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

// Add a marquee progress bar.
taskDialog.SetProgressBarMarquee();

taskDialog.DoModal();

// Remove the marquee bar and replace it with a standard progress bar
taskDialog.SetProgressBarMarquee(0);
taskDialog.SetProgressBarRange(0, 100);
taskDialog.SetProgressBarPosition(75);
taskDialog.SetProgressBarState();

taskDialog.DoModal();