WA OPEN URL
WA OPEN URL ( {* ;} object ; url )
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | → | If specified, object is an object name (string) If omitted, object is a variable |
| object | any | → | Object name (if * is specified) or Variable (if * is omitted) |
| url | Text | → | URL to load in Web area |
This command is not thread-safe, it cannot be used in preemptive code.
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 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/")