CTaskDialog::SetProgressBarRange

發行項
06/10/2015

調整進度列的範圍。

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

參數

[in] nRangeMin
進度列的下限。
[in] nRangeMax
進度列的上限 (Upper Bound)。

備註

進度列的位置是相對於 nRangeMin 和 nRangeMax。例如， nRangeMin ，如果是 50，而為 100， nRangeMax 位置 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，不小於這個方法會擲回。 ENSURE (MFC) 巨集的例外狀況。這個方法也會擲回例外狀況，如果 CTaskDialog 已顯示且具有跑馬燈進度列。

範例

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