WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIShellService

IID:95F53544-F445-48d1-B3A2-D54AA020BC3D
Inherits From:nsISupports

This interface is intended to be used as a service. To create an object implementing this interface: 

var obj = Components.classes["@mozilla.org/browser/shell-service;1"].
            getService(Components.interfaces.nsIShellService);

Constants

App types we can be registered to handle
PRUint16 MAIL = 1
PRUint16 NEWS = 2
PRUint16 RSS = 4

Properties

PRBool shouldCheckDefaultClient

Used to determine whether or not to show a "Set Default Client" query dialog. This attribute is true if the application is starting up and "mail.shell.checkDefaultClient" is true, otherwise it is false.

Methods

PRBool isDefaultClient ( PRBool startupCheck , PRUint16 apps ) void setDefaultClient ( PRBool forAllUsers , PRUint16 apps )

PRBool isDefaultClient ( PRBool startupCheck , PRUint16 apps )

Determines whether or not Thunderbird is the "Default Client" for the passed in app type.

This is simply whether or not Thunderbid is registered to handle the url scheme associatd with the app.

Arguments:
startupCheck: true if this is the check being performed by the first mail window at startup, false otherwise.
apps: the application types being tested (Mail, News, RSS, etc.)

void setDefaultClient ( PRBool forAllUsers , PRUint16 apps )

Registers Thunderbird as the "Default Mail Client" for the passed in app type.

Arguments:
forAllUsers: Whether or not Thunderbird should attempt to become the default client for all users on a multi-user system.
apps: the application types being tested (Mail, News, RSS, etc.)

Reference documentation is generated from Mozilla's source.