Adds filtering criteria to the locate, so that the next time the view is refreshed, the new criteria will be used instead of the locate defined in the task.

Note:

• When this function is used to add some criteria to the locate, then whenever the view is refreshed, the locate will be done according to these criteria.

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

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

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

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

• If there are locate criteria added by the LocateAdd function, the value of the Relocate Mode parameter in the View Refresh event will be ignored.

• 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 question mark as a value in the range or locate, precede the asterisk or question mark 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:

LocateReset, RangeAdd

The Online and Rich Client Samples projects (program DV14 and RDV14)