CTaskDialog::SetProgressBarState

Artículo
06/10/2015

Establece el estado de la barra de progreso y la muestra en CTaskDialog.

void SetProgressBarState(
   int nState = PBST_NORMAL
);

Parámetros

[in] nState
El estado de la barra de progreso. Vea la sección comentarios por los valores posibles.

Comentarios

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

La tabla siguiente se enumeran los posibles valores para nState. En todos estos casos, la barra de progreso rellenará con color regular hasta alcanzar designado detener la posición. En ese momento cambiará el color en función del estado.

PBST_NORMAL
Después de que los rellenos de barra de progreso, CTaskDialog no cambian el color de la barra. De forma predeterminada, el color regular es verde.
PBST_ERROR
Después de que los rellenos de barra de progreso, CTaskDialog cambien el color de la barra el error color. De forma predeterminada, esto es rojo.
PBST_PAUSED
Después de que los rellenos de barra de progreso, CTaskDialog cambien el color de la barra de color en pausa. De forma predeterminada, esto es amarillo.

Puede establecer en la barra de progreso detiene con CTaskDialog::SetProgressBarPosition.

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