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.

nsIHandlerApp

IID:8d298761-0963-4c90-99e2-6ea498825e82
Inherits From:nsISupports

This interface is implemented by the following components:

Properties

AString name

Human readable name for the handler

Methods

PRBool equals ( nsIHandlerApp handlerApp ) void launchWithURI ( nsIURI URI , nsIInterfaceRequestor windowContext )

PRBool equals ( nsIHandlerApp handlerApp )

Whether or not the given handler app is logically equivalent to the invokant (i.e. they represent the same app).

Two apps are the same if they are both either local or web handlers and their executables/URI templates are the same in a string comparison.

Arguments:
handlerApp: the handler app to compare to the invokant

void launchWithURI ( nsIURI URI , nsIInterfaceRequestor windowContext )

Launches the application with the specified URI.

Currently only relevant to web-handler apps. If given, this represents the docshell to load the handler in and is passed through to nsIURILoader.openURI. If this parameter is null or not present, the web handler app implementation will attempt to find/create a place to load the handler and do so. As of this writing, it tries to load the web handler in a new window using nsIBrowserDOMWindow.openURI. In the future, it may attempt to have a more comprehensive strategy which could include handing off to the system default browser (bug 394479).

Arguments:
URI: The URI to launch this application with
windowContext

References

This interface is the type of the following properties:

nsIHandlerInfo.preferredApplicationHandler

This interface is passed as an argument to the following methods:

nsIHandlerApp.equals

Reference documentation is generated from Mozilla's source.