Creating a custom web page using the Actuate JavaScript API : Viewing reports : Controlling Viewer user interface features

Controlling Viewer user interface features

Control the viewer controls and interface features with the actuate.viewer.UIOptions class. Create an instance of this class using JavaScript, as shown in the following code:

var uioptions = new actuate.viewer.UIOptions( );

Set the user interface options with the enable functions in the actuate.viewer.UIOptions class. For example, a tool bar appears in the viewer by default, as shown in Figure 1-1.

Figure 1-1  The default toolbar for the JavaScript API viewer

To disable this tool bar, use the following code:

uioptions.enableToolBar(false);

All of the enable functions take a Boolean value as an argument. To configure the viewer to use these options, use setUIOptions( ) as shown in the following code:

viewer.setUIOptions(uioptions);

The setUIOptions( ) function accepts one parameter: an actuate.viewer.UIOptions object. The viewer’s submit( ) function commits the user interface changes to the viewer when the function sends the object to the HTML container. Set the UI options using setUIOptions( ) before calling submit( ).


(c) Copyright Actuate Corporation 2011