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指示器。

下图显示了 82% 的任务栏进度指示器 ProgressValue 。

Windows 任务栏进度指示器