nsIDownloadManagerUI 编辑

toolkit/components/downloads/public/nsIDownloadManagerUI.idlScriptable This interface is used to implement the user interface for the Download Manager. If you wish to replace the default Download Manager user interface, implement this interface. 1.0 66 Introduced Gecko 1.9 Inherits from: nsISupports Last changed in Gecko 1.9 (Firefox 3)

Method overview

void getAttention();

void show([optional] in nsIInterfaceRequestor aWindowContext, [optional] in unsigned long aID, [optional] in short aReason);

Attributes

Attribute	Type	Description
visible	boolean	true if the Download Manager UI is visible; otherwise false. Read only.

Constants

Constant	Value	Description
REASON_USER_INTERACTED	0	When opening the Download Manager user interface, this value indicates that it's being done at the user's request.
REASON_NEW_DOWNLOAD	1	When opening the Download Manager user interface, this value indicates that the user interface is being displayed because a new download is being started.

Methods

getAttention()

Calls attention to the Download Manager's user interface if it's already open. The UI need not be visible to call this function, nor will the UI be made visible.

void getAttention();

Parameters

None.

Exceptions thrown

NS_ERROR_UNEXPECTED

The user interface isn't currently open.

show()

Shows the Download Manager's user interface to the user.

void show(
  in nsIInterfaceRequestor aWindowContext, Optional
  in unsigned long aID, Optional
  in short aReason Optional
);

Parameters

aWindowContext Optional

The parent window context to show the user interface. With this information, it's possible to put the Download Manager in a tab in the same window as the parent.

aID Optional

The ID of the download to be preselected upon opening the Download Manager UI.

aReason Optional

One of the reason constants indicating why the user interface should be displayed.

See also

• The Download Manager schema