Configure the appearance of the grid

When you configure the visual appearance of the Alarm Viewer control, you can:

• Include a status bar.

• Include a column header.

• Include horizontal and vertical grid lines that show the rows and columns.

• Include a run-time option that enables the user to adjust the width of columns.

• Set the colors of visual elements.

The following figure shows how the Alarm Viewer control appears when all visual properties are active.

Configure the visual appearance

1. Right-click the Alarm Viewer control, and then select Properties. The AlarmViewerCtrl Properties dialog box appears.

2. Select the General tab.

   

3. Set the visual appearance. Configure any of the following.

   Option	Description
   Perform Query on Startup	Automatically begins updating the control using default query properties. If a query is not run when the application starts, you need to run a script using the Requery() function to update the grid. The Requery option is also available on the grid’s shortcut menu during run time.
   Show Context Sensitive Menu	Enables a right-click shortcut menu during run time.
   Use Default Ack Comment	Controls whether a default comment appears when an operator acknowledges an alarm. If this box is checked and a string is entered, the string is used during run time as the default comment. If this box is not selected, when the operator acknowledges an alarm, a dialog box appears to enter an optional comment. The dialog box can be filled in or left blank.
   Retain Suppression	Retain alarm suppression between alarm queries when the alarm query is changed.
   Show Status Bar	Toggles whether the status bar appears at the bottom of the Alarm Viewer control.
   Row Selection	Enables users to select individual rows during run time. Each row represents an alarm record. Users can select multiple alarms.
   Silent Mode	If Silent Mode is selected, the Alarm Viewer control does not show error messages during run time. If it is not selected, the alarm display shows pop up error messages. In either case, error messages are always sent to the Log Viewer.
   Show Message	Shows the message typed in the text box. This is the message shown when there are no alarms.
   Show Heading	Toggles whether the heading bar appears at the top of the Alarm Viewer control.
   Use Extended Selection	Enables the user to select multiple alarms simultaneously by holding down CTRL or SHIFT keys in conjunction with the mouse button. Available only if Row Selection check box is selected.
   Flash Unack Alarms	Enables unacknowledged alarms to flash once per second until they are acknowledged. Freezing the alarm display in WindowViewer does not stop unacknowledged alarms from flashing.
   Resize Columns	If Resize Columns is selected, the user can resize the width of the columns during run time. Otherwise, column width is static and can be set only from WindowMaker.
   Show Grid	If Show Grid is selected, the Alarm Viewer control shows horizontal and vertical lines that separate the rows and columns of the alarm display. If it is not selected, no grid is visible.

4. Select Apply.

5. Select the Color tab.

   

6. Select the palette button to assign colors to the visual elements of the Alarm Viewer control.

7. Select Apply to save your color selections.

8. Select OK.