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 任务栏进度指示器