ShowURL
This command shows the given URL in a web browser. For the Java Client, a second parameter can be used to specify the frame to place the URL in.
No error is returned if the URL is invalid or cannot be displayed. As the URL is launched asynchronously, it cannot be assumed that the web page has been displayed before following script lines are executed.
In the Windows and Java Application version, HTML pages from the local disk can be shown by prefixing the file name with file:/.
Syntax
ShowURL url, [where]
Synonyms
SU
Parameters
The following table describes the parameters of the ShowURL command:
| Parameter | Description |
|---|---|
| url | The URL to display. If the URL starts with www., then the protocol is
assumed to be HTTP. |
| where | Where to show the URL. This option is only used in the Java Client version. See the following table. The default is _blank |
Values for where
Use one of the following strings.
| Value | Description |
|---|---|
| _blank | Show in a new window |
| _self | Show in the page containing the Java Client. This will close the Java Client. |
| _parent | Show in the parent frame. If there is no parent, this acts as _self. This might close the Java Client. |
| _top | Show in the top-level frame. If the Java Client is in the top-level frame this acts as _self. Warning: This might close the Java Client. |
| name | Show in the named frame. If the named frame does not exist, a new window will be created with this name. |
Examples
The following example shows the Rocket U2 home page.
ShowURL "www.rocketsoftware.com/u2"Version
6.0 Original version