## wb_set_location

bool wb_set_location (int wbobject, string location)

Sets the location of an HTMLControl or sends a special command to it. Returns `TRUE` on success or `FALSE` if an error occurs (except when using "cmd:busy" as explained below).

# Valid locations

The location parameter accepts the same URLs or file names recognized by Internet Explorer. Some examples:

Type | Examples
--- | ---
URL | http://winbinder.org/index.php http://127.0.0.1/ http://pecl.php.net/packages.php ftp://plaza.aarnet.edu.au/
File name | C:\WinBinder\Website\manual\index.html E:\WinBinder\package.xml E:\WinBinder\Readme.txt

The function also recognizes some special commands as the location parameter. All special commands must be preceded by the cmd: prefix.

Value of location | Meaning
--- | ---
"cmd:back" | Go to previously visited page.
"cmd:forward" | Go to a page previously viewed before issuing the back command.
"cmd:refresh" | Redraw the current page.
"cmd:stop" | Stop the current action, like loading a page.
"cmd:busy" | Return TRUE if the browser is busy or FALSE if idle.
"cmd:blank" | Clear the page.

# See also

Control functions