Interface nsIHelperAppLauncherDialogType

This interface is used to display a confirmation dialog before launching a "helper app" to handle content not handled by Mozilla.

Usage: Clients (of which there is one: the nsIExternalHelperAppService implementation in mozilla/uriloader/exthandler) create an instance of this interface (using the contract ID) and then call the show() method.

The dialog is shown non-modally. The implementation of the dialog will access methods of the nsIHelperAppLauncher passed in to show() in order to cause a "save to disk" or "open using" action.

Hierarchy

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

  • Async invoke a save-to-file dialog instead of the full fledged helper app dialog. When the file is chosen (or the dialog is closed), the callback in aLauncher (aLauncher.saveDestinationAvailable) is called with the selected file.

    Parameters

    • aLauncher: nsIHelperAppLauncher

      A nsIHelperAppLauncher to be invoked when a file is selected.

    • aWindowContext: nsIInterfaceRequestor

      Window associated with action.

    • aDefaultFileName: wstring

      Default file name to provide (can be null)

    • aSuggestedFileExtension: wstring

      Sugested file extension

    • aForcePrompt: boolean

      Set to true to force prompting the user for thet file name/location, otherwise perferences may control if the user is prompted.

    Returns void

  • Show confirmation dialog for launching application (or "save to disk") for content specified by aLauncher.

    Parameters

    • aLauncher: nsIHelperAppLauncher

      A nsIHelperAppLauncher to be invoked when a file is selected.

    • aWindowContext: nsIInterfaceRequestor

      Window associated with action.

    • aReason: number

      One of the constants from above. It indicates why the dialog is shown. Implementors should treat unknown reasons like REASON_CANTHANDLE.

    Returns void

Generated using TypeDoc