Method # ShowURL ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Warning
This item was deprecated in version 2021r2. Please use `System.GotoURL` as a replacement.
## Description 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. | ## Notes 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. ShowURL is not global in a web app so you need to use `WebControl.GotoURL` instead. A [URL](http://en.wikipedia.org/wiki/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 | |------------|------------------------|---------------------------------------------------------------------------| | | web site | Displays in the default web browser. | | mailto: | email | Opens the default email client with the supplied email address filled in. | | | file transfer protocol | Opens the default FTP application to download the specified file. | ## Sample code This desktop code launches the user's chosen web browser and go to the Xojo web page. ``` xojo ShowURL("http://www.xojo.com") ``` --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- This desktop code launches the user's chosen FTP client application and go to an FTP site. ``` xojo 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. ``` xojo ShowURL("mailto:diana@themyscira.org") ``` ## Compatibility All project types on all supported operating systems. ## See also `HTMLViewer`, `WebHTMLViewer` classes