TaskbarItemInfo.ProgressValue Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Shell

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia wartość wskazującą pełną wartość wskaźnika postępu na przycisku paska zadań.

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

Wartość właściwości

Double

Wartość wskazująca pełną wartość wskaźnika postępu na przycisku paska zadań. Wartość domyślna to 0.

Przykłady

W poniższym przykładzie pokazano, jak ustawić ProgressValue właściwość w kodzie. Wartość jest ustawiana w procedurze obsługi BackgroundWorker.ProgressChanged zdarzenia, aby wskazać bieżący postęp zadania w tle. Ten przykład jest częścią większego przykładu udostępnionego TaskbarItemInfo dla klasy .

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

Uwagi

Właściwość ProgressValue jest reprezentowana jako wartość z zakresu od 0,0 do 1,0. Liczby mniejsze i większe są zmuszane do bycia w tych granicach. NaN jest coerced do 0.

Postęp długotrwałych zadań można przekazać, wyświetlając wskaźnik postępu na przycisku paska zadań systemu Windows 7. Kolor wskaźnika jest określany przez ProgressState właściwość , która zawiera jedną z TaskbarItemProgressState wartości wyliczenia. ProgressState Jeśli właściwość ma Normalwartość , Pausedlub Error, ProgressValue właściwość określa pełną wartość wskaźnika postępu. ProgressValueparametr jest ignorowany dla niektórych wartości .ProgressState Indeterminate wyświetla pulsujący zielony wskaźnik na całym przycisku paska zadań. Brak wskaźnika dla .None

Na poniższej ilustracji przedstawiono wskaźnik postępu paska zadań z wartością ProgressValue 82 procent.

Przykład
Wskaźnik postępu paska zadań systemu Windows