system.net.openURL

Description

Opens the given URL outside of the currently running Client in whatever application the host operating system deems appropriate. For example, the URL:

"http://www.google.com"

... will open in the default web browser, whereas this one:

"file://C:\Report.pdf"

... will likely open in Adobe Acrobat. The Windows network-share style path like:

"\\Fileserver\resources\machine_manual.pdf"

... will work as well (in Windows).

Be careful not to use this function in a full-screen client, as launching an external program will break your full-screen exclusive mode.

Syntax

system.net.openURL(url [, useApplet])

Parameters

String url - The URL to open in a web browser.

boolean useApplet - If set to true (1), and the client is running as an Applet, then the browser instance that launched the applet will be used to open the URL. [optional]

Returns

nothing

Scope

Client

Examples

Example 1:

# This code would open a web page

system.net.openURL("http://www.google.com")

Example 2:

# This code would open a PDF document from a Windows-based file server

# Note the double backslashes are needed because backslash is the escape character 

# for Jython

system.net.openURL("\\\\MyServer\\MyDocs\\document.pdf")