The ListButton module enables you to draw a button that will change the category of alarms that are displayed in a specified alarm list when clicked. ListButton takes the following parameters:
\AlarmPanel\ListButton(Name, ButtonLabel, PostitLabel, SelList)
Name is the name of the DrawList variable that holds the panel information (see the Name parameter in Displaying an Alarm List – DrawList Module).
ButtonLabel is the text label to display on the button.
PostitLabel is the text to display on the tool tip that appears when the mouse is rested over the button.
SelList indicates which list this button will select when clicked. The options are:
-2: Current alarms list (merged active and unacknowledged lists)
-1: All registered alarms list
0: Log or "history" list
1: Disabled alarms list
2: Active alarms list
3: Unacknowledged alarms list
4+: User-defined alarms list
Note: VTS includes a built-in tool for drawing a button to acknowledge all unacknowledged alarms without requiring you to alter any code. Information on the Alarm Tools library can be found in "VTS Developer's Guide: Alarm Tools Library". Information specific to the Alarm List tool that enables you to draw such a button on a application page can be found in "VTS Developer's Guide: Ack All Button Alarm Library Tool".