TaskbarItemInfo.ProgressValue Property
Gets or sets a value that indicates the fullness of the progress indicator in the taskbar button.
Namespace: Microsoft.Windows.Shell
Assembly: Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)
Syntax
'Declaration
Public Property ProgressValue As Double
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)
Property Value
Type: System.Double
A value that indicates the fullness of the progress indicator in the taskbar button. The default is 0.
Remarks
The ProgressValue property is represented as a value between 0.0 and 1.0. Numbers smaller and larger are coerced to be within those bounds. NaN is coerced to 0.
You can communicate the progress of long-running tasks by displaying a progress indicator in a Windows 7 taskbar button. The color of the indicator is determined by the ProgressState property, which contains one of the TaskbarItemProgressState enumeration values. If the ProgressState property is Normal, Paused, or Error, the ProgressValue property determines the fullness of the progress indicator. ProgressValue is ignored for some values of ProgressState. Indeterminate shows a pulsing green indicator across the entire taskbar button. No indicator is shown for None.
The following illustration shows the taskbar progress indicator with a ProgressValue of 82 percent.
Windows Taskbar Progress Indicator
.png "Taskbar Item Info Sample")
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.