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