CTaskDialog::SetProgressBarRange

Articolo
06/10/2015

Regola l'intervallo dell'indicatore di stato.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Parametri

[in] nRangeMin
Il limite inferiore dell'indicatore di stato.
[in] nRangeMax
Il limite superiore dell'indicatore di stato.

Note

La posizione dell'indicatore di stato è relativo a nRangeMin e nRangeMax. Ad esempio, se nRangeMin è 50 e nRangeMax è 100, un percorso di 75 è la metà strada l'indicatore di stato. Utilizzare CTaskDialog::SetProgressBarPosition per impostare la posizione dell'indicatore di stato.

Per visualizzare l'indicatore di stato, l'opzione TDF_SHOW_PROGRESS_BAR deve essere abilitata e TDF_SHOW_MARQUEE_PROGRESS_BAR non deve essere abilitato. Questo metodo imposta automaticamente TDF_SHOW_PROGRESS_BAR e cancella TDF_SHOW_MARQUEE_PROGRESS_BAR. Utilizzo CTaskDialog::SetOptions modificare manualmente le opzioni per questa istanza Classe CTaskDialog.

Questo metodo genera un'eccezione con la macro ENSURE (MFC) se nRangeMin non è minore nRangeMax. Questo metodo viene generata un'eccezione se CTaskDialog già visualizzare e ha un indicatore di stato di marquee.

Esempio

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