CTaskDialog::SetProgressBarState

Artigo
06/10/2015

Define o estado de barra de progresso e o exibe em CTaskDialog.

void SetProgressBarState(
   int nState = PBST_NORMAL
);

Parâmetros

[in] nState
O estado de barra de progresso. Consulte a seção comentários para os valores possíveis.

Comentários

Este método gera uma exceção com a macro de ENSURE (MFC) se CTaskDialog é exibido e já tem uma barra de progresso de famoso.

A tabela a seguir lista os valores possíveis para nState. Em todos esses casos, a barra de progresso preencherá com a cor normal até que o escopo para parar a posição. Em esse ponto irá alterar a cor com base no estado.

PBST_NORMAL
Após a barra de progresso, preenche CTaskDialog não altera a cor de barra. Por padrão, a cor normal é verde.
PBST_ERROR
Após a barra de progresso, preenche CTaskDialog altera a cor de barra para a cor de erro. Por padrão, isso é vermelho.
PBST_PAUSED
Após a barra de progresso, preenche CTaskDialog altera a cor de barra para a cor em pausa. Por padrão, isso é amarelo.

Você pode definir onde a barra de progresso para CTaskDialog::SetProgressBarPositioncom.

Exemplo

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