HTML dashboard control

Display an HTML file or a URL (webpage) on a dashboard window using the HTML web browser dashboard control. This control can automatically refresh at a user-defined time interval or it can refresh along with the dashboard window.

This example of an HTML dashboard control is loaded with a URL (an active webpage) on the dashboard window:

Note: The HTML dashboard control on a dashboard in run mode displays a Microsoft Internet Explorer right-click menu. Please refer to Internet Explorer for documentation relevant to this topic.

The HTML control Properties dialog options

Some of the HTML control properties (attributes) may be familiar in usage and may not require additional explanation. Many of the properties featured in this topic are specifically designed for GainSeeker users.

See Using the Properties dialog

Adding an HTML control to the dashboard window

1. Click the HTML button on the dashboard controls toolbar on a dashboard window that is open in design/edit mode.

An informational dialog opens.

2. Click URL or File to specify display type.

For more information, see If the URL option is selected... or If the File option is selected...

If the URL option is selected...

The Enter Value dialog opens.

1. Enter a URL in the text field. Then, click OK.

The selected URL loads on the control on the host dashboard window in design/edit mode.

See Editing the HTML control properties for more information.

If the File option is selected...

The Select File dialog opens.

1. Select the HTML file for the control to display. Then, click Open.

2. The control opens on the host dashboard window in design/edit mode

See Editing the HTML control properties for more information.

Editing the HTML control properties

To select the HTML control for edit:

• Click the HTML tab on the upper-left corner of the control on a dashboard window that is open in design/edit mode, or

• Click HTML in the drop-down list on the Properties dialog on a dashboard window that is open in design/edit mode.

The properties grid on the Property dialog displays the property values specific to that control.

Editing the (Url or file) property

The (Url or file) property value cell specifies the URL or file name to which the control has navigated. The file or webpage the control displays can also be edited in the property value cell.

To edit the (Url or file) property value cell:

1. Select the existing file name or URL in the property value cell. Then, enter a new file name or URL.

2. Press the keyboard ENTER key.

Editing the AllowNavigation property

Use the AllowNavigation property value in the Properties dialog to specify whether the web browser control can browse to another page after it initially loads.

To set the AllowNavigation property:

1. Click the AllowNavigation drop-down list in the property value cell under Behavior. Then:

1. • Click True to enable navigation to other webpages and websites, or

   • Click False to not allow navigation to other webpages and websites.

Editing the ScrollBarsEnabled property

Here is an example of scrollbars on a HTML control on a dashboard window in run mode:

To set the ScrollBarsEnabled property value:

1. Click the ScrollBarsEnabled drop-down list in the property value cell in the Behavior category. Then:

• Click True to enable the scrollbars function, or

• Click False to disable the scrollbars function. (The scrollbars will not show on the control in run mode.)

Editing other HTML properties

For information about editing some of the other HTML properties, see:

• Using the Timer property

• Using the TimerFileNameExport property

• Z Order property

Changing the HTML control location on the dashboard

There are two ways to change the location of the dashboard control on the dashboard:

• Click and hold the control tab (circled in red for this example) while dragging (moving) the control to a new location on the dashboard window.

• Expand the Location property value cell under Layout in the Properties dialog box. Then, select the numeric values in the Location or X or Y property value cells and enter a numeric value for the new location of the control.

Deleting dashboard controls

• See Deleting dashboard controls from the dashboard window

Technical notes

• Getting JavaScript errors? See Information about Turning off JavaScript errors

• When sending the dashboard to HTML, this control does not always display well in the resulting HTML file.