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 da propriedade

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

Exemplos

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

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

Comentários

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

Você pode comunicar o progresso das tarefas de execução prolongada exibindo um indicador de progresso em um 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, Pausedou Error, a ProgressValue propriedade determinará 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. Nenhum indicador é mostrado para None.

A ilustração a seguir mostra o indicador de progresso da barra de tarefas com ProgressValue 82%.

Exemplo de informações de da de tarefas da barra de tarefas Indicador de progresso da barra de tarefas do Windows