CTaskDialog::SetProgressBarRange

Artikel
02/26/2013

Passt den Bereich der Statusanzeige.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Parameter

[in] nRangeMin
Die untere Grenze der Statusanzeige.
[in] nRangeMax
Die Obergrenze der Statusanzeige.

Hinweise

Die Position der Statusanzeige ist relativ zu nRangeMin und nRangeMax.Wenn nRangeMin 50 ist und nRangeMax 100 ist, ist eine Position 75 über der Statusanzeige halb.Verwenden Sie CTaskDialog::SetProgressBarPosition, um die Position der Statusanzeige festzulegen.

Um die Statusanzeige anzuzeigen, muss die Option TDF_SHOW_PROGRESS_BAR aktiviert und TDF_SHOW_MARQUEE_PROGRESS_BAR darf nicht aktiviert werden.Diese Methode legt automatisch TDF_SHOW_PROGRESS_BAR fest und löscht TDF_SHOW_MARQUEE_PROGRESS_BAR.Verwendung CTaskDialog::SetOptions, die Optionen für diese Instanz CTaskDialog-Klasse manuell zu ändern.

Diese Methode löst eine Ausnahme mit dem STELLEN SEH SICHER (MFC)-Makro aus, wenn nRangeMin nicht kleiner als nRangeMax ist.Diese Methode auch löst eine Ausnahme aus, wenn CTaskDialog bereits angezeigt wird aus und verfügt über eine Laufschriftstatusanzeige.

Beispiel

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