Class
DataGridSearchSettings

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:

cs-api-definition
public class DataGridSearchSettings : BindableObject

Inheritance: objectDataGridSearchSettings

Constructors

DataGridSearchSettings()

Initializes a new instance of the class.

Declaration

cs-api-definition
public DataGridSearchSettings()

Fields

ApplyFilterProperty

Identifies the ApplyFilter property.

Declaration

cs-api-definition
public static readonly BindableProperty ApplyFilterProperty

Field Value

BindableProperty

CaseSensitiveProperty

Identifies the CaseSensitive property.

Declaration

cs-api-definition
public static readonly BindableProperty CaseSensitiveProperty

Field Value

BindableProperty

CloseSearchPanelCommandProperty

Identifies the CloseSearchPanelCommand property.

Declaration

cs-api-definition
public static readonly BindableProperty CloseSearchPanelCommandProperty

Field Value

BindableProperty

DataGridProperty

Identifies the DataGrid property.

Declaration

cs-api-definition
public static readonly BindableProperty DataGridProperty

Field Value

BindableProperty

IntermediateSearchTextProperty

Identifies the IntermediateSearchText property.

Declaration

cs-api-definition
public static readonly BindableProperty IntermediateSearchTextProperty

Field Value

BindableProperty

ProvideSearchMatchesActionProperty

Identifies the ProvideSearchMatchesAction property.

Declaration

cs-api-definition
public static readonly BindableProperty ProvideSearchMatchesActionProperty

Field Value

BindableProperty

ResultsSummaryProperty

Identifies the ResultsSummary property.

Declaration

cs-api-definition
public static readonly BindableProperty ResultsSummaryProperty

Field Value

BindableProperty

SearchEntryCompletedCommandProperty

Identifies the SearchEntryCompletedCommand property.

Declaration

cs-api-definition
public static readonly BindableProperty SearchEntryCompletedCommandProperty

Field Value

BindableProperty

SearchMatchesCountProperty

Identifies the SearchMatchesCount property.

Declaration

cs-api-definition
public static readonly BindableProperty SearchMatchesCountProperty

Field Value

BindableProperty

SearchPanelVisibilityModeProperty

Identifies the SearchPanelVisibilityMode property.

Declaration

cs-api-definition
public static readonly BindableProperty SearchPanelVisibilityModeProperty

Field Value

BindableProperty

SearchTextProperty

Identifies the SearchText property.

Declaration

cs-api-definition
public static readonly BindableProperty SearchTextProperty

Field Value

BindableProperty

SearchTriggerProperty

Identifies the SearchTrigger property.

Declaration

cs-api-definition
public static readonly BindableProperty SearchTriggerProperty

Field Value

BindableProperty

TextMatchModeProperty

Identifies the TextMatchMode property.

Declaration

cs-api-definition
public static readonly BindableProperty TextMatchModeProperty

Field Value

BindableProperty

Properties

ApplyFilter

Gets or sets a value that determines whether business items that do not satisfy the search criteria should be filtered.

Declaration

cs-api-definition
public bool ApplyFilter { get; set; }

Property Value

bool

CaseSensitive

Gets or sets a value indicating whether string comparison should be case sensitive.

Declaration

cs-api-definition
public bool CaseSensitive { get; set; }

Property Value

bool

CloseSearchPanelCommand

Gets or sets the command that is executed when pressing the close button in the DataGridSearchPanel.

Declaration

cs-api-definition
public ICommand CloseSearchPanelCommand { get; set; }

Property Value

ICommand

DataGrid

Gets the corresponding RadDataGrid.

Declaration

cs-api-definition
public RadDataGrid DataGrid { get; }

Property Value

RadDataGrid

IntermediateSearchText

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.

Declaration

cs-api-definition
public string IntermediateSearchText { get; set; }

Property Value

string

ProvideSearchMatchesAction

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.

Declaration

cs-api-definition
public Action<DataGridSearchProbe> ProvideSearchMatchesAction { get; set; }

Property Value

Action<DataGridSearchProbe>

ResultsSummary

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.

Declaration

cs-api-definition
public string ResultsSummary { get; }

Property Value

string

SearchEntryCompletedCommand

Gets the command that is executed when the Completed event of the search entry in the DataGridSearchPanel is raised.

Declaration

cs-api-definition
public ICommand SearchEntryCompletedCommand { get; }

Property Value

ICommand

SearchMatchesCount

Gets the number of search matches.

Declaration

cs-api-definition
public int SearchMatchesCount { get; }

Property Value

int

SearchPanelVisibilityMode

Gets or sets a value indicating the user experience with the visibility of the DataGridSearchPanel and its close button.

Declaration

cs-api-definition
public DataGridSearchPanelVisibilityMode SearchPanelVisibilityMode { get; set; }

Property Value

DataGridSearchPanelVisibilityMode

SearchText

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.

Declaration

cs-api-definition
public string SearchText { get; set; }

Property Value

string

SearchTrigger

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.

Declaration

cs-api-definition
public DataGridSearchTrigger SearchTrigger { get; set; }

Property Value

DataGridSearchTrigger

TextMatchMode

Gets or sets a value indicating how a search term should be searched for within a text element.

Declaration

cs-api-definition
public DataGridSearchTextMatchMode TextMatchMode { get; set; }

Property Value

DataGridSearchTextMatchMode

Methods

GetResultsSummary()

Invoked when updating the ResultsSummary property.

Declaration

cs-api-definition
protected virtual string GetResultsSummary()

Returns

string

Summarized information about the search results in the current search operation.

OnSearchResultsChanged(IEnumerable<DataGridSearchResultsItem>)

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.

Declaration

cs-api-definition
public virtual void OnSearchResultsChanged(IEnumerable<DataGridSearchResultsItem> searchResults)

Parameters

searchResults

IEnumerable<DataGridSearchResultsItem>

A collection of search results.

ProvideSearchMatches(DataGridSearchProbe)

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.

Declaration

cs-api-definition
protected virtual void ProvideSearchMatches(DataGridSearchProbe probe)

Parameters

probe

DataGridSearchProbe

An entity that contains information about the item, such as text of the item, the effective search text, and more.

Events

SearchStarting

An event that is raised before searching starts. The effective search text can be changed and searching can be cancelled from the arguments.

Declaration

cs-api-definition
public event EventHandler<DataGridSearchStartingEventArgs> SearchStarting

Event Value

EventHandler<DataGridSearchStartingEventArgs>