ContentsIndexPreviousNext

Methods

Note that methods are implemented as properties in ACUCOBOL-GT. To invoke a method, you modify the control, setting the values of various properties that represent the method parameters. Then, usually in the same modify statement, you set a particular property that represents the method to invoke. Sometimes just setting the value of a control invokes a method.
Here is a table of the methods with their corresponding ACUCOBOL-GT WEB-BROWSER control properties and descriptions:

Method
ACUCOBOL-GT WEB-BROWSER control property
Description
GoBack
GO-BACK
Navigates to the previous item in the history list.

GoForward
GO-FORWARD
Navigates to the next item in the history list.

GoHome
GO-HOME
Navigates to the current configured home or start page.

GoSearch
GO-SEARCH
Navigates to Microsoft's web portal site.

Navigate
VALUE
Navigates to a resource identified by a URL or file path.

Refresh
REFRESH
Reloads the current page.

Stop
STOP
Stops any pending navigation or download.

To invoke the GoBack, GoForward, GoHome, GoSearch, Refresh, and Stop methods you simply modify the control, setting the appropriate properties to "1". To invoke the Navigate method, modify the control setting the VALUE property to the desired URL. For example, to invoke the GoBack method:

MODIFY BROWSER-1 GO-BACK=1.

To invoke the Navigate method:

MODIFY BROWSER-1 VALUE="http://www.acucorp.com".

or if you have defined the WEB-BROWSER control with value URL-1 in a screen section item called BROWSER-SCREEN:

MOVE "http://www.acucorp.com" to URL-1.
 DISPLAY BROWSER-SCREEN.

These methods are invoked asynchronously. This means that the MODIFY verb may finish executing before the operation is complete. You may check the value of the BUSY property (see below) to determine whether the operation has completed.