TcxDataFindCriteria.GoToNextMatch Method

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

Declaration

function GoToNextMatch: Boolean;

Returns

Type
Boolean

Remarks

Call this function to navigate forward between rows that meet the filter or search criteria. The function moves focus to the next 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 GoToNextMatch 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 Next button, or presses the F3 or Enter key in search mode.

Note

A successful GoToNextMatch function call synchronizes focus and active selection.

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