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://hypervisual.com/winbinder/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