TaskbarItemInfo.ProgressState Property

Gets or sets a value that indicates how the progress indicator is displayed in the taskbar button.

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)

Syntax

'Declaration
Public Property ProgressState As TaskbarItemProgressState

public TaskbarItemProgressState ProgressState { get; set; }

public:
property TaskbarItemProgressState ProgressState {
    TaskbarItemProgressState get ();
    void set (TaskbarItemProgressState value);
}

member ProgressState : TaskbarItemProgressState with get, set

function get ProgressState () : TaskbarItemProgressState
function set ProgressState (value : TaskbarItemProgressState)

Property Value

Type: Microsoft.Windows.Shell.TaskbarItemProgressState
An enumeration value that indicates how the progress indicator is displayed in the taskbar button. The default is None.

Remarks

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. When the ProgressState is Normal, the indicator is green. When Paused, the indicator is yellow. When Error, the indicator is red. For these states, the ProgressValue property determines how much of the taskbar button is filled by the progress indicator. ProgressValue is ignored for other 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 in the Normal state.

Windows Taskbar Progress Indicator

.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.

See Also

Reference

TaskbarItemInfo Class

Microsoft.Windows.Shell Namespace