TaskbarItemInfo.ProgressValue 属性

2011-08-12

获取或设置一个值，该值指示任务栏按钮中进度指示器的填满状态。

命名空间： Microsoft.Windows.Shell
程序集： Microsoft.Windows.Shell（在 Microsoft.Windows.Shell.dll 中）

语法

声明
Public Property ProgressValue As Double
    Get
    Set

public double ProgressValue { get; set; }

public:
property double ProgressValue {
    double get ();
    void set (double value);
}

member ProgressValue : float with get, set

function get ProgressValue () : double
function set ProgressValue (value : double)

属性值

类型：System.Double
一个值，该值指示任务栏按钮中进度指示器的填满状态。默认值为 0。

备注

ProgressValue 属性以 0.0 和 1.0 之间的值表示。较小和较大的数字强制在这些界限内。 NaN 强制为 0。

您可以通过在 Windows 7 任务栏按钮中显示进度指示器来传达长时间运行的任务的进度。指示符的颜色由包含一个 TaskbarItemProgressState 枚举值的 ProgressState 属性确定。如果 ProgressState 属性为 Normal、Paused 或 Error，则 ProgressValue 属性确定进度指示器的填满状态。对于 ProgressState 的一些值，忽略 ProgressValue。 Indeterminate 在整个任务栏按钮中显示一个绿色的脉冲指示器。没有为 None 显示指示器。

以下插图显示任务栏进度指示器，此时显示 ProgressValue 为 82%。

Windows 任务栏进度指示器

任务栏项目信息示例