version 6.5
HIGHLIGHT RECORDS {(setName)}
| Parameter | Type | Description | |
| setName | String | Set of records to highlight or | |
| Useret if omitted |
Description
The command HIGHLIGHT RECORDS allows you to highlight records in an output form. This operation is identical to manually selecting records in list mode by using the mouse or the Shift+Click or Ctrl+Click (Command+Click on MacOS) keyboard equivalents.
The "selected" records will be highlighted. The current selection is not modified.
Note: The Userset set is updated after redrawing the records; that is, after executing the entire calling method and not just immediately after executing HIGHLIGHT RECORDS.
If you pass a valid set name to setName, the command will be applied to the records in that set.
If you omit the setName parameter, the command will only highlight the records in the current Userset set.
Example
In an output form displayed by the MODIFY SELECTION command, you want the user to be able to perform searches without the current selection being modified. To do so, place a Search button in the form and associate to it the following method:
SET QUERY DESTINATION(Into Set;"UserSet") QUERY SET QUERY DESTINATION(Into Current Selection) HIGHLIGHT RECORDS
When the user clicks the button, the standard query dialog box appears. Once the search has been validated, the records found will be highlighted without the current selection being modified.