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.
Show confirmation dialog for launching application (or “save to
disk”) for content specified by aLauncher.
| aLauncher | A nsIHelperAppLauncher to be invoked when a file is selected. |
| aWindowContext | Window associated with action. |
| aReason | One of the constants from above. It indicates why the dialog is shown. Implementors should treat unknown reasons like REASON_CANTHANDLE. |
Invoke a save-to-file dialog instead of the full fledged helper app dialog.
Returns the a nsIFile for the file name/location selected.
@throws NS_ERROR_NOT_AVAILABLE if the async version of this function
should be used.
| aLauncher | A nsIHelperAppLauncher to be invoked when a file is selected. |
| aWindowContext | Window associated with action. |
| aDefaultFileName | Default file name to provide (can be null) |
| aSuggestedFileExtension | Sugested file extension |
| aForcePrompt | Set to true to force prompting the user for thet file name/location, otherwise perferences may control if the user is prompted. |
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.
| aLauncher | A nsIHelperAppLauncher to be invoked when a file is selected. |
| aWindowContext | Window associated with action. |
| aDefaultFileName | Default file name to provide (can be null) |
| aSuggestedFileExtension | Sugested file extension |
| aForcePrompt | Set to true to force prompting the user for thet file name/location, otherwise perferences may control if the user is prompted. |
This request is passed to the helper app dialog because Gecko can not
handle content of this type.
The server requested external handling.
Gecko detected that the type sent by the server (e.g. text/plain) does
not match the actual type.