CTaskDialog::SetProgressBarRange

项目
03/01/2013

调整进度栏的大小。

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

参数

[in] nRangeMin
进度栏的下限。
[in] nRangeMax
进度栏的上限。

备注

进度栏的位置相对于 nRangeMin 和 nRangeMax。例如，因此，如果 nRangeMin 为50，并 nRangeMax 为100，位置75在进度栏中的中间。使用 CTaskDialog::SetProgressBarPosition 设置进度栏的位置。

若要显示进度栏，必须启用选项 TDF_SHOW_PROGRESS_BAR，并且无法启用 TDF_SHOW_MARQUEE_PROGRESS_BAR。此方法会自动设置 TDF_SHOW_PROGRESS_BAR 并清除 TDF_SHOW_MARQUEE_PROGRESS_BAR。使用 CTaskDialog::SetOptions 手动更改 CTaskDialog类选件的此实例的选项。

如果 nRangeMin 比 nRangeMax，不小于此方法引发与确保(MFC) 宏的异常。此方法还引发异常，如果 CTaskDialog 已突出显示并具有marquee进度栏。

示例

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