CTaskDialog::SetProgressBarRange

Artigo
02/25/2013

Ajustar o intervalo de barra de progresso.

void SetProgressBarRange(
   int nRangeMin,
   int nRangeMax
);

Parâmetros

[in] nRangeMin
O limite inferior de barra de progresso.
[in] nRangeMax
O limite superior de barra de progresso.

Comentários

A posição de barra de progresso é relativo a nRangeMin e nRangeMax.Por exemplo, se nRangeMin é 50 e nRangeMax é 100, uma posição de 75 é incompleta através de barra de progresso.Use CTaskDialog::SetProgressBarPosition para definir a posição de barra de progresso.

Para exibir a barra de progresso, a opção TDF_SHOW_PROGRESS_BAR deve ser ativada e TDF_SHOW_MARQUEE_PROGRESS_BAR não deve ser ativado.Este método automaticamente define TDF_SHOW_PROGRESS_BAR e limpa TDF_SHOW_MARQUEE_PROGRESS_BAR.Use CTaskDialog::SetOptions para alterar manualmente as opções para essa instância de Classe de CTaskDialog.

Este método gera uma exceção com a macro de GARANTIR (MFC) se nRangeMin não é menor que nRangeMax.Esse método também gera uma exceção se CTaskDialog é exibido e já tem uma barra de progresso de famoso.

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