Checkbox Group Rules

<< Click to Display Table of Contents >>

Navigation:  ReportView Manager > Checkbox Group Manager >

Checkbox Group Rules

Previous pageReturn to chapter overviewNext page

As a convenience, you can optionally cause various checkboxes in the group to behave a certain way when you check or uncheck another checkbox by adding rules. For example, if you have both "Inspected" and "Not Inspected" checkboxes, you most likely will not want to allow both to be checked at the same time; therefore, you can add rules to prevent this from occurring.

 

TopicCheckboxGroupManager

 

Clicking on the [Actions Editor] to make changes to these rules:

 

CheckboxGroupActionsEditor

 

Events (occur when the user clicks on one of the checkboxes):

 

OnCheck Event specifies what to do when a user checks the named checkbox.

Example: OnCheck(Inspected)

 

OnUncheck Event specifies what to do when a user unchecks the named checkbox

Example: OnUncheck(Inspected)

 

Actions (taken when a particular event occurs):

 

Check these Checks the specified named checkbox(es)

Example: Check(Inspected)

 

UnCheck these Unchecks the specified named checkbox(es)

Example: UnCheck(Not Inspected, Not Present)

 

Enable these Enables the specified named checkbox(es)

Example: Enable(Deficient)

 

Disable these Disables the specified named checkbox(es)

Example: Disable(Not Present, Deficient)

 

So, to prevent both the Inspected and Not Inspected checkboxes from both being checked or not checked at the same time, you can add these rules (the Actions Editor will add the appropriate action rule sequence so that you do not have to manually add or modify the rules yourself):

 

OnCheck(Inspected):UnCheck(Not Inspected)

OnCheck(Not Inspected):UnCheck(Inspected)

OnUncheck(Inspected):Check(Not Inspected)

OnUncheck(Not Inspected):Check(Inspected)

 

 

Notes:

 

The rules are not recursive, meaning that, in the above example, the unchecking action of the "Not Inspected" checkbox in the first rule does not trigger the last rule's event, OnUncheck(Not Inspected).

 

Only one event can occur per checkbox click, so only the first "OnCheck" event that matches the actual event will be processed (i.e. don't bother to have two "OnCheck(Inspected)" events because the second one would never get processed).

 

The name specified inside the parentheses must match the actual name of the checkbox given in the Checkboxes list; therefore, if you rename one of the checkboxes you must remember to change the name in the rules as well. The name is not case sensitive.

 

You can add additional actions to a single event by either adding other checkbox names in the action's parameter list, separated by commas, or joining different actions using the "and" clause. For example, if you also wanted to uncheck and disable say, the "Deficient" checkbox when you check the "Not Inspected" checkbox, you can create the rule:

 

OnCheck(Not Inspected):Uncheck(Inspected, Deficient) and Disable(Deficient)