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 A為82%。

Windows 工作列進度指示器