You can use #Span.DoNotSearchOnEnter on a seeker ViewModel to prevent the search associated with a seeker column from starting when the user presses Enter.
Default behavior
In a seeker ViewModel, a column tagged as a seeker provides a search action. By default, pressing Enter starts that search.
For example, if a user enters a customer name in a seeker column and presses Enter, the seeker search runs immediately.
Disable search on Enter
Set #Span.DoNotSearchOnEnter to turn off the Enter-key search behavior for the seeker ViewModel.
When this setting is enabled, pressing Enter in the seeker input does not start the search. The user must use the search button to run it.
= Example
A seeker ViewModel contains a Name column tagged as a seeker:
- Default: The user types
Annaand presses Enter. The search starts. - With #Span.DoNotSearchOnEnter: The user types
Annaand presses Enter. No search starts; the user selects the search button to run the search.
When to use it
Use this setting when Enter should not submit a seeker search. For example, this can prevent an unintended search while a user is entering or editing search criteria.
This setting changes only whether Enter starts the search. It does not define how many rows the seeker search returns. To limit returned rows, see Seek form (web).