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.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void SetParameters(
    string[] fieldNames,
    string text,
    FindPanelParserKind kind = FindPanelParserKind.Default,
    FilterCondition condition = FilterCondition.Default
)

VB.NET

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

Parameters

Name	Type	Description
fieldNames	String[]	Names of fields 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