TaskbarItemInfo.ProgressValue Propriedade

public:
 property double ProgressValue { double get(); void set(double value); };

public double ProgressValue { get; set; }

member this.ProgressValue : double with get, set

Public Property ProgressValue As Double

Valor de Propriedade

Um valor que indica a plenitude do indicador de progresso no botão da barra de tarefas. A predefinição é 0.

Exemplos

O exemplo a seguir mostra como definir a ProgressValue propriedade no código. O valor é definido no handler de um BackgroundWorker.ProgressChanged evento para indicar o progresso atual da tarefa em segundo plano. Este exemplo faz parte de um exemplo mais amplo fornecido à TaskbarItemInfo turma.

void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    this.tbCount.Text = e.ProgressPercentage.ToString();
    // Update the value of the task bar progress indicator.
    this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
}

Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
    Me.tbCount.Text = e.ProgressPercentage.ToString()
    ' Update the value of the task bar progress indicator.
    Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
End Sub

Observações

A ProgressValue propriedade é representada como um valor entre 0,0 e 1,0. Números menores e maiores são coagidos a estar dentro desses limites. NaN é coagido a 0.

Pode comunicar o progresso de tarefas de longa duração mostrando um indicador de progresso num botão da barra de tarefas do Windows 7. A cor do indicador é determinada pela ProgressState propriedade, que contém um dos valores de TaskbarItemProgressState enumeração. Se a ProgressState propriedade for Normal, Paused, ou Error, a ProgressValue propriedade determina a plenitude do indicador de progresso. ProgressValue é ignorado para alguns valores de ProgressState. Indeterminate Mostra um indicador verde pulsante em todo o botão da barra de tarefas. Não é mostrado nenhum indicador para None.

A ilustração seguinte mostra o indicador de progresso da barra de tarefas com uma nota ProgressValue de 82 por cento.

Windows Indicador de Progresso da Barra de Tarefas