nsITaskbarProgress 编辑

widget/public/nsITaskbarProgress.idlScriptable Starting in Windows 7, applications can display a progress notification in the taskbar. This class wraps around the native functionality to do this. 1.0 66 Introduced Gecko 1.9.2 Inherits from: nsISupports Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)

Method overview

void setProgressState(in nsTaskbarProgressState state, in unsigned long long currentValue Optional, in unsigned long long maxValue Optional);

Constants

Constant	Value	Description
STATE_NO_PROGRESS	0	Stop displaying progress on the taskbar button. This should be used when the operation is complete or canceled.
STATE_INDETERMINATE	1	Display a cycling, indeterminate progress bar.
STATE_NORMAL	2	Display a determinate, normal progress bar.
STATE_ERROR	3	Display a determinate, error progress bar.
STATE_PAUSED	4	Display a determinate progress bar indicating that the operation has paused.

Methods

setProgressState()

Sets the taskbar progress state and value for this window. The currentValue and maxValue parameters are optional and should be supplied when state is one of STATE_NORMAL, STATE_ERROR or STATE_PAUSED.

void setProgressState(
  in nsTaskbarProgressState state,
  in unsigned long long currentValue, Optional
  in unsigned long long maxValue Optional
);

Parameters

state

One of the state constants.

currentValue

The current progress value.

maxValue

The maximum progress value.

Exceptions thrown

NS_ERROR_ILLEGAL_VALUE

If currentValue is greater than maxValue.

NS_ERROR_INVALID_ARG

If state is STATE_NO_PROGRESS or STATE_INDETERMINATE, and either currentValue or maxValue is not 0.

See also

• nsIWinTaskbar
• Windows 7 Taskbar APIs