ShowURL

Method

Uses the appropriate web browser application (based on the user’s Internet settings) to go to the HTTP URL specified.

Usage

ShowURL(URL)

Part	Type	Description
URL	String	The HTTP address to go to. Other types of addresses (ftp, smb, mailto) depend on the operating system and the browser. In a Web Edition application, it replaces the existing page with the passed URL.

Target	Available	Notes
Desktop	Yes	Displays the supplied URL in the user's default web browser. If the browser is not open, it will launch the browser. Whether the URL opens in a new tab or a new window is controlled by the user's browser settings.
Web	Yes	The supplied URL replaces the currently display page in the web app. ShowURL is not global in a web app so you need to use WebControl.ShowURL or WebSession.ShowURL instead.
Console	No

A URL is an address for Internet locations such as web sites, FTP and email addresses.

Some web browsers have a limit on the length of a URL. These are common prefixes:

URL Prefix	Type	Notes
http://	web site	Displays in the default web browser.
mailto:	email	Opens the default email client with the supplied email address filled in.
ftp://	file transfer protocol	Opens the default FTP application to download the specified file.

This desktop code launches the user's chosen web browser and go to the Xojo web page.

ShowURL("http://www.xojo.com")

This desktop code launches the user's chosen FTP client application and go to an FTP site.

ShowURL("ftp://ftp.mysite.com/uploads")

This desktop code launches the user's chosen email application and create a new email message, with the specified email address in the "To" area.

ShowURL("mailto:diana@themyscira.org")