LookUpEditAutoSearchEventArgs.SetParameters(String, String, FindPanelParserKind, FilterCondition) Method

Allows you to change how the lookup editor searches for items in its drop-down panel.

Namespace: DevExpress.XtraEditors.Controls

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

C#

public void SetParameters(
    string fieldName,
    string text,
    FindPanelParserKind kind = FindPanelParserKind.Default,
    FilterCondition condition = FilterCondition.Default
)

VB.NET

Public Sub SetParameters(
    fieldName As String,
    text As String,
    kind As FindPanelParserKind = FindPanelParserKind.Default,
    condition As FilterCondition = FilterCondition.Default
)

Parameters

Name	Type	Description
fieldName	String	The name of a field whose values should be compared with the search text.
text	String	A text to compare with data source records.

Optional Parameters

Name	Type	Default	Description
kind	FindPanelParserKind	Default	If a text entered into the editor text box contains whitespaces, the editor splits this string into separate logical blocks. This parameter specifies how these blocks are combined into a search query.
condition	FilterCondition	Default	The condition according to which the editor searches for the string entered into its text box.

Remarks

The example below illustrates how to limit the search by the “Ship Country” and “Ship City” fields, and change the search condition to “Starts with…”.

C#

lookUpEdit1.AutoSearch += OnAutoSearch;

void OnAutoSearch(object sender, LookUpEditAutoSearchEventArgs e) {
    string[] fields = new string[] { "ShipCity", "ShipCountry" };
    e.SetParameters(fields, e.Text, FindPanelParserKind.And, FilterCondition.StartsWith);
}

VB.NET

Private lookUpEdit1.AutoSearch += AddressOf OnAutoSearch

Private Sub OnAutoSearch(ByVal sender As Object, ByVal e As LookUpEditAutoSearchEventArgs)
    Dim fields() As String = { "ShipCity", "ShipCountry" }
    e.SetParameters(fields, e.Text, FindPanelParserKind.And, FilterCondition.StartsWith)
End Sub