Browse selection and query interaction
- Last Updated: April 10, 2024
- 1 minute read
- OpenEdge
- Version 12.8
- Documentation
When a browse is initialized, the buffer for its query contains the first record in the query, since the user has not yet selected a record. To keep the browse in sync with the query, the buffer contains the first record in the browse viewport while there is no selected record. Whenever the user selects a row, that row becomes the current row in the query’s buffer.
In a multiple-select browse, if you deselect the current row, the query is repositioned to the previously selected row. If no rows are selected, the query is repositioned to the first record in the viewport.
The following table summarizes how actions on the browse affect the associated query.
| Browse action | Effect on query |
|---|---|
| Vertical keyboard navigation | Moves the result list cursor for single-select browse widgets |
| Select row | Puts records for that row into the record buffers |
| Deselect current row | If other records are selected in the browse, puts records for the most recently selected of those rows into the record buffers; otherwise, repositions to the first row in the viewport |
| Deselect noncurrent row | None |
Using the GET statement (such as GET NEXT) to navigate
within the result list of the query has no effect on the browse. However, the
REPOSITION statement does update the current position of the
browse. If you use GET statements for a query on which a browse is
defined, you should use the REPOSITION statement to keep the browse
synchronized with the query. Also, when you open or reopen the query with the
OPEN QUERY statement, the browse is automatically refreshed and
positioned to the first record.