nsIExternalProtocolService

IID:100FD4B3-4557-11d4-98D0-001083010E9B
Inherits From:nsISupports

The external protocol service is used for finding and launching platform specific applications for particular protocols.

You can ask the external protocol service if it has an external handler for a given protocol scheme. And you can ask it to load the url using the default handler.

This interface is implemented by the following components:


Methods

PRBool externalProtocolHandlerExists ( char* protocolScheme ) PRBool isExposedProtocol ( char* protocolScheme ) void loadUrl ( nsIURI URL )

PRBool externalProtocolHandlerExists ( char* protocolScheme )

Check whether a handler for a specific protocol exists.

Arguments:
protocolScheme: The scheme from a url: http, ftp, mailto, etc.
Returns:
true if we have a handler and false otherwise.

PRBool isExposedProtocol ( char* protocolScheme )

Check whether a handler for a specific protocol is "exposed" as a visible feature of the current application.

An exposed protocol handler is one that can be used in all contexts. A non-exposed protocol handler is one that can only be used internally by the application. For example, a non-exposed protocol would not be loaded by the application in response to a link click or a X-remote openURL command. Instead, it would be deferred to the system's external protocol handler.

Arguments:
protocolScheme

void loadUrl ( nsIURI URL )

Used to load a url via an external protocol handler (if one exists)

Arguments:
URL: The url to load

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com