CTaskDialog::SetProgressBarRange

Artículo
06/10/2015

ajusta el radio de acción de barra de progreso.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Parámetros

[in] nRangeMin
El límite inferior de la barra de progreso.
[in] nRangeMax
el límite superior de la barra de progreso.

Comentarios

la posición de la barra de progreso es nRangeMin en relación con y nRangeMax. por ejemplo, si nRangeMin es 50 y nRangeMax es 100, una posición de 75 es intermedia a través de la barra de progreso. utilice CTaskDialog::SetProgressBarPosition para establecer la posición de la barra de progreso.

Para mostrar la barra de progreso, la opción TDF_SHOW_PROGRESS_BAR debe estar habilitada y TDF_SHOW_MARQUEE_PROGRESS_BAR no debe estar habilitado. Este método establece automáticamente TDF_SHOW_PROGRESS_BAR y borra TDF_SHOW_MARQUEE_PROGRESS_BAR. uso CTaskDialog::SetOptions de cambiar manualmente las opciones para esta instancia de CTaskDialog Class.

Este método produce una excepción con la macro de ENSURE (MFC) si nRangeMin no es menor que nRangeMax. Este método también produce una excepción si CTaskDialog se muestra ya y tiene una barra de progreso de la marquesina.

Ejemplo

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