TcxDataFindCriteria.GoToPreviousMatch Method

Moves focus to the previous row that meets the active filter or search criteria.

Declaration

function GoToPreviousMatch: Boolean;

Returns

Type
Boolean

Remarks

Call this function to navigate backwards between rows that meet the filter or search criteria. The function moves focus to the previous row that meets the active filter or search criteria and returns True. If there are no search results or an attempt to move focus fails for any reason, the GoToPreviousMatch function leaves focus at the current position and returns False.

The associated container control’s Find Panel calls this function when a user clicks the Previous button, or presses the Shift+F3 or Shift+Enter key combination in search mode.

Note

A successful GoToPreviousMatch function call synchronizes focus and active selection.

The GoToPreviousMatch function calls the GetPreviousMatchIndex function internally to identify if it should move focus from the current position and where to proceed.