revGoURL
Type
command
Summary
Used to open a URL in a web browser.
Syntax
revGoURL <URL>
Description
The revGoURL command was previously used to open a web page in the user's browser application from within a stack.
On Windows and Linux systems, the URL is opened by the default system application for the url type. For "http" URLs, this will be the system default web browser, for "file" URLs it will be the default application associated with that file.
On Mac OS and OS X systems, the URL is opened in the application the user has set for that URL protocol in the Internet control panel (or, for older system versions, Internet Config). For example, "mailto:" URLs are opened in the email program, "http:" URLs are opened in the web browser, and so on.
On Mac OS systems, the revGoURL command requires that AppleScript be installed and that the GURL Apple Event be supported. GURL support is included in Mac OS 8.5 or later, and is available for Mac OS 8.0 and 8.1 if the "Internet Scripting" file is installed in the "Scripting Additions" folder inside the Extensions folder. (This file is installed by the Internet Access installer on the 8.0 installation CD.) The revGoURL command is not supported for Mac OS versions before 8.0.
If the URL contains quotes, it is necessary either to URLEncode it or to replace the quotes with "%22", or unexpected behavior may be experienced.
When included in a standalone application, the Common library is implemented as a hidden group and made available when the group receives its first openBackground message. During the first part of the application's startup process, before this message is sent, the revGoURL command is not yet available. This may affect attempts to use this command in startup, preOpenStack, openStack, or preOpenCardhandlers in the main stack. Once the application has finished starting up, the library is available and the revGoURL command can be used in any handler.
Parameters
| Name | Type | Description |
|---|---|---|
URL | An expression that evaluates to a URL. |
Examples
revGoURL "http://www.example.org/info.html"
revGoURL "http://me:secret@www.example.com/secret-plan/"
revGoURL it
revGoURL "mailto:guido@sales.example.com"
revGoURL "file:///Folder/file.html"
Related
library: Common library, library
message: startup, openBackground, preOpenStack, openStack
object: stack
command: revMail, launch url
function: URLEncode
glossary: application, AppleScript, main stack, handler, message, group, Mac OS, standalone application, Apple Event, command, browser
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
Platforms
desktop
server