AlarmFilterForm | Alarm Filter Functions

Cicode Programming Reference > Cicode Function Categories > Alarm Filter Functions > AlarmFilterForm

AlarmFilterForm

Displays a form for specifying filtering criteria for either an alarm list or a named filter. This function uses the AlarmFilterEdit family of Cicode functions to set the filter.

Note: If the user passes in the Animation number of an alarm list as its FitlerSrc argument, the filter set by this function will override the filter set by function AlarmSetInfo() as both functions modify the internal filter associated with the alarm list.

Syntax

INT AlarmFilterForm(INT nIndex, INT nMode = 0, INT nDebug = 0, STRING nFilterSrc = "-1")

Index

0 - Active Alarm form
1- Summary Alarm form
2 – Disabled alarms
3 – Sequence of events (SOE)
-1 – auto-detection, only works if argument sFilterSrc is AN of an alarm list

Mode

0 is for form having datetime as drop list and no shift interface;
1 is for form having datetime as droplets and shift interface;
2 is for form having datetime as field and no shift interface;
3 is for form having datetime as field and shift interface

Debug

For debugging filter values; 1 will write filter parameters to file - filter.txt in the [run] folder

FilterSrc

The source where the filter will be applied to. It can either be the Animation Number (AN) of an alarm list or the name of a filter created via the AlarmFilterOpen() Cicode function. If it is not specified, it is defaulted to -1 which refers to all alarm lists on the current page.

Return Value

1 if filter has been applied, 0 if filter has been cleared, or -1 if no change is made.

Related Functions

AlarmResetQuery, AlarmFilterOpen