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.

nsIHelperAppLauncherDialog

IID:64355793-988d-40a5-ba8e-fcde78cac631
Inherits From:nsISupports

This interface is used to display a confirmatino 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.

This interface is implemented by the following components:

Constants

This request is passed to the helper app dialog because Gecko can not handle content of this type.
PRUint32 REASON_CANTHANDLE = 0
The server requested external handling.
PRUint32 REASON_SERVERREQUEST = 1
Gecko detected that the type sent by the server (e.g. text/plain) does not match the actual type.
PRUint32 REASON_TYPESNIFFED = 2

Methods

nsILocalFile promptForSaveToFile ( nsIHelperAppLauncher launcher , nsISupports windowContext , PRUnichar* defaultFile , PRUnichar* suggestedFileExtension ) void show ( nsIHelperAppLauncher launcher , nsISupports context , PRUint32 reason )

nsILocalFile promptForSaveToFile ( nsIHelperAppLauncher launcher , nsISupports windowContext , PRUnichar* defaultFile , PRUnichar* suggestedFileExtension )

Arguments:
launcher
windowContext
defaultFile
suggestedFileExtension

void show ( nsIHelperAppLauncher launcher , nsISupports context , PRUint32 reason )

Arguments:
launcher
context
reason

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com