Compartilhar via


CTaskDialog::SetProgressBarState

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

Requisitos

Cabeçalho: afxtaskdialog.h

Consulte também

Referência

Classe de CTaskDialog

Gráfico de hierarquia

CTaskDialog::SetProgressBarMarquee

CTaskDialog::SetProgressBarRange

CTaskDialog::SetProgressBarPosition