Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxDataFindCriteria.GoToNextMatch Method

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

#Declaration

Delphi
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.

See Also