4D Doc Center : WA OPEN URL

Home

4D v14.3

WA OPEN URL


WA OPEN URL ( {* ;} object ; path )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a variable
object	Form object	Object name (if * is specified) or Variable (if * is omitted)
path	String	URL to load in Web area

Description

The WA OPEN URL command loads the URL passed in the url parameter into the Web area designated by the * and object parameters.

If an empty string is passed in url, the command does nothing and no error is generated. To load a blank page into the Web area, pass the string "about:blank" in url.

Like the existing OPEN WEB URL command, WA OPEN URL accepts several types of syntaxes in the url parameter to designate the files:

posix syntax: "file:///c:/My%20File"
system syntax: "c:\MyFolder\MyFile" (Windows) or "MyDisk:MyFolder:MyFile" (Mac OS).

Note: For compatibility, the "file://" syntax (using two "/") is accepted in 4D but it does not conform to RFC. We recommend using the "file:///" syntax (with three "/") that complies with RFC.

On Mac OS, when FileVault is activated, you must use the Posix syntax. You can transform paths of the system using the Convert path system to POSIX command.

This command has the same effect as modifying the value of the "URL" variable associated with the area. For example, if the variable of the area is named MyWArea_url:

MyWArea_url:="http://www.4d.com/"

is the same as:

WA OPEN URL(MyWArea;"http://www.4d.com/")