The process described here is an extension of the general process for using controls that is specific to the SAP HTML Viewer. It does not contain all of the steps required to produce a valid instance of the control.

1. Create a reference variable for the SAP HTML Viewer.

DATA html_viewer TYPE REF TO cl_gui_html_viewer.

2. Create an instance of the SAP HTML Viewer:

CREATE OBJECT html_viewer

EXPORTING parent  = container.

Register the Events

3. Register the required events of the SAP HTML Viewer. It supports the following events:

Event name	Meaning
SAPEVENT	Click on a special HTML link that triggers an SAP event
NAVIGATE_COMPLETE	HTML page fully loaded

Using the SAP HTML Viewer

Load HTML pages or parts of HTML pages.

4. Display the loaded objects.
5. Navigate forwards and backwards in the stack of your HTML browser from the application program, or return to the homepage.
6. Update the HTML page from your application program.
7. Find out the address of the current page.

Destroying the Control

The lifetime management is normally responsible for destroying any controls you use. However, the following two steps allow you to destroy the control yourself:

8. Destroy the SAP HTML Viewer at the frontend. If you no longer need the control container, release it as well:

CALL METHOD html_viewer->free.

9. Delete the reference variable to the SAP HTML Viewer and, if necessary, the reference to the control container as well: