Partilhar via


TaskbarItemInfo.ProgressValue Propriedade

Definição

Obtém ou define um valor que indica o preenchimento do indicador de progresso no botão da barra de tarefas.

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 o preenchimento do indicador de progresso no botão da barra de tarefas. O padrão é 0.

Exemplos

O exemplo a seguir mostra como definir a propriedade ProgressValue 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 menores e maiores são coagidos a estar dentro desses limites. NaN é coagido a 0.

Você pode comunicar o progresso de 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 TaskbarItemProgressState valores de 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 um ProgressValue de 82%.

item da barraExemplo de informações de de tarefas Exemplo de
Indicador de Progresso da Barra de Tarefas do Windows

Aplica-se a