Adds filtering criteria to the range, so that the next time the view is refreshed, the new criteria will be used (in addition to the range defined in the task).

Note:

• The RangeAdd function adds criteria to the task range. When the view is refreshed, the range is done according to the task range and the criteria added in both the RangeAdd and RangeExpAdd functions.

• The variable names should be unique in the data view.

• The variable sent can be of parent tasks, so the relevant task range criteria will be updated.

• This function can be used several times in order to perform the range on multiple variables.

• The NULL function can be used as a value. In this case, a null value will be sent.

• The asterisk (*) or question mark (?) characters used in the main source's range or locate is used as a wildcard character. It represents a string of characters. The asterisk and question mark can only be used as the last character in a string.

• To use the asterisk or character as a value in the range or locate, precede the asterisk or character with a backslash (\). Since version: 1.9h

Examples:

Examples of range and locate syntax:

• a* will do the range or locate on a* (where * is a wildcard character)

• a\* will do the range or locate on a* (where * is a string)

• a\\ will be a\

• a\\* will do the range or locate on a\* (where * is a wildcard character)

• a\b will remain a\b

See also:

RangeReset, LocateAdd

The Online and Rich Client Samples projects (program DV13 and RDV13)