CTaskDialog::SetProgressBarRange

Článek
03/04/2013

Nastaví rozsah indikátor průběhu.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Parametry

[v]nRangeMin
Dolní mez indikátor průběhu.
[v]nRangeMax
Horní mez indikátor průběhu.

Poznámky

Je pozice indikátoru průběhu relativně nRangeMin a nRangeMax .Například pokud nRangeMin je 50 a nRangeMax 100, pozice 75 je uprostřed přes indikátor průběhu.Použití CTaskDialog::SetProgressBarPosition nastavit pozici indikátor průběhu.

Zobrazit průběh panel možnost TDF_SHOW_PROGRESS_BAR musí být povolena a TDF_SHOW_MARQUEE_PROGRESS_BAR nesmí být povolena.Tato metoda se automaticky nastaví TDF_SHOW_PROGRESS_BAR a vymaže TDF_SHOW_MARQUEE_PROGRESS_BAR .Použití CTaskDialog::SetOptions ručně změnit možnosti pro tuto instanci Třída CTaskDialog.

Tato metoda vyvolá výjimku s ZAJIŠTĚNÍ (MFC) makro-li nRangeMin je nejméně nRangeMax .Tuto metodu také vyvolá výjimku, pokud CTaskDialog je již zobrazen a má indikátor průběhu hranice výběru.

Příklad

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