CTaskDialog::SetProgressBarState

Article
06/10/2015

Définit l'état de la barre de progression et l'affiche dans CTaskDialog.

void SetProgressBarState(
   int nState = PBST_NORMAL
);

Paramètres

[in] nState
l'état de la barre de progression. Consultez la section Notes pour les valeurs possibles.

Notes

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

Le tableau suivant répertorie les valeurs possibles pour nState. Dans tous ces cas, la barre de progression remplira de couleur normale jusqu'à ce qu'il atteigne indiqué arrêtent la position. À ce stade elle modifie la couleur selon l'état.

PBST_NORMAL
Une fois la barre de progression remplisse, CTaskDialog ne modifie pas la couleur de la barre. Par défaut, la couleur normale est verte.
PBST_ERROR
Une fois la barre de progression remplisse, CTaskDialog modifie la couleur de la barre par la couleur d'erreur. Par défaut, c'est rouge.
PBST_PAUSED
Une fois la barre de progression remplisse, CTaskDialog modifie la couleur de la barre par la couleur en pause. Par défaut, il s'agit de jaune.

Vous pouvez définir où la barre de progression s'arrête à CTaskDialog::SetProgressBarPosition.

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