A class that contains information about the settings related to a search operation and the views related to it.
Definition
Namespace:Telerik.Maui.Controls.DataGrid
Assembly:Telerik.Maui.Controls.dll
Syntax:
public class DataGridSearchSettings : BindableObject
Inheritance: objectDataGridSearchSettings
Constructors
Initializes a new instance of the class.
public DataGridSearchSettings()
Fields
ApplyFilterProperty
BindableProperty
Identifies the ApplyFilter property.
public static readonly BindableProperty ApplyFilterProperty
CaseSensitiveProperty
BindableProperty
Identifies the CaseSensitive property.
public static readonly BindableProperty CaseSensitiveProperty
CloseSearchPanelCommandProperty
BindableProperty
Identifies the CloseSearchPanelCommand property.
public static readonly BindableProperty CloseSearchPanelCommandProperty
DataGridProperty
BindableProperty
Identifies the DataGrid property.
public static readonly BindableProperty DataGridProperty
IntermediateSearchTextProperty
BindableProperty
Identifies the IntermediateSearchText property.
public static readonly BindableProperty IntermediateSearchTextProperty
ProvideSearchMatchesActionProperty
BindableProperty
Identifies the ProvideSearchMatchesAction property.
public static readonly BindableProperty ProvideSearchMatchesActionProperty
ResultsSummaryProperty
BindableProperty
Identifies the ResultsSummary property.
public static readonly BindableProperty ResultsSummaryProperty
SearchEntryCompletedCommandProperty
BindableProperty
Identifies the SearchEntryCompletedCommand property.
public static readonly BindableProperty SearchEntryCompletedCommandProperty
SearchMatchesCountProperty
BindableProperty
Identifies the SearchMatchesCount property.
public static readonly BindableProperty SearchMatchesCountProperty
SearchPanelVisibilityModeProperty
BindableProperty
Identifies the SearchPanelVisibilityMode property.
public static readonly BindableProperty SearchPanelVisibilityModeProperty
SearchTextProperty
BindableProperty
Identifies the SearchText property.
public static readonly BindableProperty SearchTextProperty
SearchTriggerProperty
BindableProperty
Identifies the SearchTrigger property.
public static readonly BindableProperty SearchTriggerProperty
TextMatchModeProperty
BindableProperty
Identifies the TextMatchMode property.
public static readonly BindableProperty TextMatchModeProperty
Properties
Gets or sets a value that determines whether business items that do not satisfy the search criteria should be filtered.
public bool ApplyFilter { get; set; }
Gets or sets a value indicating whether string comparison should be case sensitive.
public bool CaseSensitive { get; set; }
Gets or sets the command that is executed when pressing the close button in the DataGridSearchPanel.
public ICommand CloseSearchPanelCommand { get; set; }
Gets the corresponding RadDataGrid.
public RadDataGrid DataGrid { get; }
Gets or sets the text of the search entry. Change of this value will not necessarily trigger a search, i.e. it will not necessarily change the SearchText property. The SearchText property is updated in accordance to the SearchTrigger property.
public string IntermediateSearchText { get; set; }
Gets or sets the custom action that is invoked when determining the search matches for a an item. Use this action when you need to specify search matches based on custom logic. See also ProvideSearchMatches(DataGridSearchProbe) which allows to invoke the base logic.
public Action<DataGridSearchProbe> ProvideSearchMatchesAction { get; set; }
Gets a summary of the search results, like the number of search matches. You can override the GetResultsSummary() method when you need to change its value.
public string ResultsSummary { get; }
Gets the command that is executed when the Completed event of the search entry in the DataGridSearchPanel is raised.
public ICommand SearchEntryCompletedCommand { get; }
Gets the number of search matches.
public int SearchMatchesCount { get; }
Gets or sets a value indicating the user experience with the visibility of the DataGridSearchPanel and its close button.
public DataGridSearchPanelVisibilityMode SearchPanelVisibilityMode { get; set; }
Gets or sets the search text. Before a search is started, this value is trimmed, and the SearchStarting event is raised and it allows to change the effective search text that will be used for searching.
public string SearchText { get; set; }
Gets or sets a value indicating when a search operation should be performed while the end user is typing in the search entry of the DataGridSearchPanel is raised.
public DataGridSearchTrigger SearchTrigger { get; set; }
Gets or sets a value indicating how a search term should be searched for within a text element.
public DataGridSearchTextMatchMode TextMatchMode { get; set; }
Methods
Invoked when updating the ResultsSummary property.
protected virtual string GetResultsSummary()
Summarized information about the search results in the current search operation.
Invoked when the search results change. You can override this method to add custom logic by either adding or removing search matches. You can also call this method to provide custom search matches.
public virtual void OnSearchResultsChanged(IEnumerable<DataGridSearchResultsItem> searchResults)
A collection of search results.
Invoked when probing for search matches. You can override this method and the Matches collection to add custom logic by either adding or removing search matches.
protected virtual void ProvideSearchMatches(DataGridSearchProbe probe)
An entity that contains information about the item, such as text of the item, the effective search text, and more.
Events
An event that is raised before searching starts. The effective search text can be changed and searching can be cancelled from the arguments.
public event EventHandler<DataGridSearchStartingEventArgs> SearchStarting