Configure 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.

Configure the appearance

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

2. Select 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 checkbox 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 checkbox to activate the shortcut menu. Select Configure Context Menus to configure what commands appear on the menu. For more information, see Control which features users can access at run time.

   • In the Display Mode list, select 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 checkbox to sort the tree elements in alphabetical order. Select either Ascending or Descending for the sort direction.

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

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

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

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

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

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

4. Select Apply.

5. Select the Color tab.

   

6. Select 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. Select Apply.