Configuring the Appearance and Colors

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

• Include a status bar.

• Include a column header.

• Set the colors of visual elements.

To configure the appearance

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

2. Click the General tab.

   

3. Configure how the Alarm Tree Viewer control appears to run-time users. Do any of the following:

   • Select the Perform Query on Startup check box for the tree to automatically update using default query properties. Otherwise, users must run the Refresh command to update the tree.

   • Select the Show Context Sensitive Menu check box to activate the shortcut menu. Click Configure Context Menus to configure what commands appear on the menu. For more information, see Controlling Which Features Users Can Access at Run Time.

   • In the Display Mode list, click how you want the tree to refresh. For an automatic refresh, type the refresh interval the Auto Refresh Interval box. The range is 5 to 32767 seconds.

   • In the Expansion Level box, type the number of expansion levels for the tree. This determines to which alarm group branch level the alarm tree is opened when you manually refresh the control. A value of 1 shows only the provider, a value of 2 shows the direct alarm groups of the provider, and so on.

   • Select the Sort Elements in Alphabetical Order check box to sort the tree elements in alphabetical order. Click either Ascending or Descending for the sort direction.

   • Select the Show Heading check box to show a header above the hierarchy. In the box, type the header bar text.

   • Select the Show Status Bar check box to show a status bar at the bottom of the Alarm Tree Viewer control.

   • Click Font to configure the font properties for the tree. The standard Windows Font dialog box appears.

   • Select the Element Selection check box to enable users to select an element in the tree.

   • Select the Allow Multiple Selections check box to enable users to select one or more elements using the CTRL and SHIFT keys.

   • Select the Silent Mode check box prevent the Alarm Tree Viewer control from showing run-time error messages. Error messages are always sent to the Logger.

4. Click Apply.

5. Click the Color tab.

   

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

   You can set the colors of the title bar text, window background, selected element text, and selected element background.

7. Click Apply.