TaskbarItemInfo.ProgressValue 屬性

定義

命名空間:

System.Windows.Shell

組件:

PresentationFramework.dll

取得或設定值，這個值表示進度列指示器在工作列按鈕中的飽和度。

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

屬性值

Double

值，這個值表示進度列指示器在工作列按鈕中的飽和度。 預設值是 0。

範例

下列範例示範如何利用程式碼設定 ProgressValue 屬性。 值是在事件的處理常式 BackgroundWorker.ProgressChanged 中設定，以指出背景工作的目前進度。 此範例是針對 類別提供的較大範例的 TaskbarItemInfo 一部分。

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

備註

屬性 ProgressValue 會以介於 0.0 到 1.0 之間的值表示。 較小的數位和較大的數位會強制在這些界限內。 NaN 強制為 0。

您可以在 Windows 7 工作列按鈕中顯示進度指標，以傳達長時間執行工作的進度。 指標的色彩取決於 ProgressState 屬性，其中包含其中 TaskbarItemProgressState 一個列舉值。 ProgressState如果 屬性為 Normal 、 Paused 或 Error ，則 ProgressValue 屬性會決定進度指標的完整程度。 ProgressValue 針對 的 ProgressState 一些值，會忽略 。 Indeterminate 顯示整個工作列按鈕的綠色衝動指標。 沒有針對 None 顯示指標。

下圖顯示工作列進度指標，其值為 ProgressValue 82%。

Windows 工作列進度指標