Interface nsIHandlerAppType

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

Hierarchy

Properties

detailedDescription: string

Detailed description for this handler. Suitable for a tooltip or short informative sentence.

name: string

Human readable name for the handler

Methods

  • Increases the reference count for this interface. The associated instance will not be deleted unless the reference count is returned to zero.

    Returns

    The resulting reference count.

    Returns number

  • Parameters

    • aIID: object
    • Optional aInstancePtr: object

    Returns any

  • A run time mechanism for interface discovery.

    Returns

    NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.

    aInstancePtr must not be null.

    Parameters

    • aIID: object

      [in] A requested interface IID

    • aInstancePtr: object

      [out] A pointer to an interface pointer to receive the result.

    Returns void

  • Decreases the reference count for this interface. Generally, if the reference count returns to zero, the associated instance is deleted.

    Returns

    The resulting reference count.

    Returns number

  • 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 and command line parameters are the same.

    Returns

    true if the two are logically equivalent, false otherwise

    Parameters

    • aHandlerApp: nsIHandlerApp

      the handler app to compare to the invokant

    Returns boolean

  • Launches the application with the specified URI.

    Parameters

    • aURI: nsIURI

      The URI to launch this application with

    • aBrowsingContext: BrowsingContext

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

    Returns void

Generated using TypeDoc