LookUpEdit.PopupFilter Event

Allows you to specify a custom filter expression for the LookUpEdit popup list.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v25.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Events")]
public event PopupFilterEventHandler PopupFilter

VB.NET

<DXCategory("Events")>
Public Event PopupFilter As PopupFilterEventHandler

Event Data

The PopupFilter event's data class is DevExpress.XtraEditors.Controls.PopupFilterEventArgs.

Remarks

The LookUpEdit raises the PopupFilter event before the dropdown list appears. Handle the PopupFilter event to filter records in the dropdown list. Use the e.Criteria event parameter to specify the filter expression.

The following example restricts the dropdown list to records where the “ShipCountry” field equals “Brazil”:

C#

using DevExpress.Data.Filtering;
using DevExpress.XtraEditors.Controls;

void LookUpEdit1_PopupFilter(object sender, PopupFilterEventArgs e) {
    e.Criteria = CriteriaOperator.Parse("ShipCountry == 'Brazil'");
}

VB.NET

Imports DevExpress.Data.Filtering
Imports DevExpress.XtraEditors.Controls

Private Sub LookUpEdit1_PopupFilter(ByVal sender As Object, ByVal e As PopupFilterEventArgs)
    e.Criteria = CriteriaOperator.Parse("ShipCountry == 'Brazil'")
End Sub