TaskbarItemInfo.ProgressValue Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der die Volle der Statusanzeige in der Taskleistenschaltfläche angibt.
public:
property double ProgressValue { double get(); void set(double value); };public double ProgressValue { get; set; }member this.ProgressValue : double with get, setPublic Property ProgressValue As DoubleEigenschaftswert
Ein Wert, der die Vollständigkeit der Statusanzeige in der Taskleistenschaltfläche angibt. Der Standardwert lautet 0.
Beispiele
Das folgende Beispiel zeigt, wie die ProgressValue Eigenschaft im Code festgelegt wird. 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 innerhalb dieser Grenzen umgewandelt. NaN wird auf "0" umgewandelt.
Sie können den Fortschritt langer Ausgeführter Aufgaben 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 Normalist , Pausedoder Error, bestimmt die ProgressValue Eigenschaft die Fülle der Statusanzeige. ProgressValue wird für einige Werte von ProgressState. Indeterminate zeigt einen pulsierenden grünen Indikator über die gesamte Taskleistenschaltfläche an. Es wird kein Indikator für None.
Die folgende Abbildung zeigt die Statusanzeige der Taskleiste mit einem ProgressValue Wert von 82 Prozent.
zu Statusanzeige der Windows-Taskleiste
