CTaskDialog::SetProgressBarRange

Article
03/04/2013

Règle la plage de la barre de progression.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Paramètres

[in] nRangeMin
La limite inférieure de la barre de progression.
[in] nRangeMax
La limite supérieure de la barre de progression.

Notes

La position de la barre de progression est à nRangeMin relatif et nRangeMax.Par exemple, si nRangeMin est 50 et nRangeMax est 100, une position de 75 est à moitié sur la barre de progression.Utilisez CTaskDialog::SetProgressBarPosition pour définir la position de la barre de progression.

Pour afficher la barre de progression, l'option TDF_SHOW_PROGRESS_BAR doit être activée et TDF_SHOW_MARQUEE_PROGRESS_BAR ne doit pas être activée.Cette méthode définit automatiquement TDF_SHOW_PROGRESS_BAR et efface TDF_SHOW_MARQUEE_PROGRESS_BAR.Utilisation CTaskDialog::SetOptions de modifier manuellement les options pour cette instance de De classe CTaskDialog.

Cette méthode lève une exception avec la macro d' GARANTISSEZ (MFC) si nRangeMin n'est pas moins qu' nRangeMax.Cette méthode également lève une exception si CTaskDialog est déjà affichée et une barre de progression de la bannière.

Exemple

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