Freigeben über


TaskbarItemInfo.ProgressValue Eigenschaft

Definition

Ruft einen Wert ab, der den Füllzustand der Statusanzeige in der Taskleistenschaltfläche angibt, oder legt ihn fest.

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

Eigenschaftswert

Ein Wert, der den Füllzustand der Statusanzeige in der Taskleistenschaltfläche angibt. Die Standardeinstellung ist 0.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die ProgressValue-Eigenschaft im Code festlegen. Der Wert wird im Handler eines BackgroundWorker.ProgressChanged Ereignisses festgelegt, um den aktuellen Fortschritt der Hintergrundaufgabe anzugeben. Dieses Beispiel ist Teil eines größeren Beispiels, das für die TaskbarItemInfo -Klasse bereitgestellt wird.

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

Hinweise

Die ProgressValue Eigenschaft wird als Wert zwischen 0,0 und 1,0 dargestellt. Zahlen, die kleiner und größer sind, werden dazu verpflichtet, sich innerhalb dieser Grenzen zu befinden. NaN wird zu 0 geerct.

Sie können den Fortschritt von Aufgaben mit langer Ausführungszeit kommunizieren, indem Sie eine Statusanzeige in einer Windows 7-Taskleistenschaltfläche anzeigen. Die Farbe des Indikators wird durch die ProgressState -Eigenschaft bestimmt, die einen der TaskbarItemProgressState Enumerationswerte enthält. Wenn die ProgressState -Eigenschaft , Pausedoder ErroristNormal, bestimmt die ProgressValue -Eigenschaft die Fülle des Statusindikators. ProgressValue wird für einige Werte von ProgressStateignoriert. Indeterminate zeigt einen pulsierenden grünen Indikator über die gesamte Taskleistenschaltfläche an. Für Nonewird kein Indikator angezeigt.

Die folgende Abbildung zeigt den Statusindikator der Taskleiste mit einem ProgressValue Wert von 82 Prozent.

Beispiel für Taskleistenelementinformationen: Beispiel für
Statusanzeige der Windows-Taskleiste

Gilt für: