TaskbarItemInfo.ProgressValue Tulajdonság

Definíció

Névtér:

System.Windows.Shell

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállít egy értéket, amely a tálcán található állapotjelző teljességét jelzi.

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

Tulajdonság értéke

Double

Olyan érték, amely a tálcán megjelenő állapotjelző teljességét jelzi. Az alapértelmezett érték a 0.

Példák

Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot kódban ProgressValue . Az érték egy BackgroundWorker.ProgressChanged esemény kezelőjében van beállítva, hogy jelezze a háttérfeladat aktuális állapotát. Ez a példa egy nagyobb, az TaskbarItemInfo osztályhoz tartozó példa része.

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

Megjegyzések

A ProgressValue tulajdonság értéke 0,0 és 1,0 között van. A kisebb és nagyobb számok kényszerítve vannak arra, hogy ezeken a korlátokon belül legyenek. NaN 0-ra van kényszerítve.

A hosszú ideig futó tevékenységek előrehaladását egy Windows 7 tálcán megjelenő állapotjelzővel közölheti. A mutató színét a ProgressState tulajdonság határozza meg, amely az TaskbarItemProgressState enumerálási értékek egyikét tartalmazza. Ha a ProgressState tulajdonság Normal, Pausedvagy Errora ProgressValue tulajdonság határozza meg a folyamatjelző teljességét. ProgressValue a rendszer figyelmen kívül hagyja a . egyes értékeit ProgressState. Indeterminate egy lüktető zöld jelzést jelenít meg a teljes tálcagombon. Nem jelenik meg mutató a következőhöz None: .

Az alábbi ábrán a tálca állapotjelzője látható 82 százalékkal ProgressValue .

Windows Tálca állapotjelzője