VoDbClearLocate Function |  |
Clear a locate condition by deleting the locate code block.
Namespace: XSharp.RT
Assembly: XSharp.RT (in XSharp.RT.dll) Version: 2.21
SyntaxRemarks
VODBClearLocate() clears the locate condition by deleting the locate code block.
By default, this function operates on the currently selected work area.
It can be made to operate on an unselected work area by specifying it within an aliased expression A locate condition can be set by DBLocate(), VODBLocate(), VODBSetLocate(), or the LOCATE command. Note that this function does not call the error handler and will not, therefore, produce a runtime error message or create an error object if it fails. Thus, it may be important to check the return value to determine if the function succeeded. The global structure, StrucErrInfo, will contain needed information regarding any error that occurs.
It can be made to operate on an unselected work area by specifying it within an aliased expression A locate condition can be set by DBLocate(), VODBLocate(), VODBSetLocate(), or the LOCATE command. Note that this function does not call the error handler and will not, therefore, produce a runtime error message or create an error object if it fails. Thus, it may be important to check the return value to determine if the function succeeded. The global structure, StrucErrInfo, will contain needed information regarding any error that occurs.
Examples
This example sets and retrieves a locate code block, evaluates it against the current record, and finally cleans up:
X#
1DBUseArea(TRUE, "DBFNTX", "address",; 2 "Address", TRUE) 3VODBSetLocate({|| Name == "Odile"}) 4// Process filtered records 5VODBClearLocate() 6// Process unfiltered records 7DBCloseArea()
See Also