nsIHandlerApp in Firefox 3.6a1pre

Implemented by

[scriptable, uuid(8d298761-0963-4c90-99e2-6ea498825e82)]

Attributes

 nsIHandlerApp represents an external application that can handle content
 of some sort (either a MIME type or a protocol).

 FIXME: now that we've made nsIWebHandlerApp inherit from nsIHandlerApp,
 we should also try to make nsIWebContentHandlerInfo inherit from or possibly
 be replaced by nsIWebHandlerApp (bug 394710).


 Human readable name for the handler

attribute AString name

Methods

 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.

 @param aHandlerApp the handler app to compare to the invokant

 @returns true if the two are logically equivalent, false otherwise

boolean equals(in nsIHandlerApp aHandlerApp)

 Launches the application with the specified URI.

 @param aURI
        The URI to launch this application with

 @param aWindowContext 

        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).

void launchWithURI(in nsIURI aURI, [optional] in nsIInterfaceRequestor aWindowContext)