A newer version of this page is available. Switch to the current version.

RepositoryItemLookUpEdit.PopupFilterMode Property

Gets or sets how data records in the popup window are filtered.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

[DXCategory("Data")]
[DefaultValue(PopupFilterMode.Default)]
public PopupFilterMode PopupFilterMode { get; set; }

Property Value

Type Default Description
PopupFilterMode

Default

A PopupFilterMode enumerator value that specifies how data records in the popup window are filtered.

Available values:

Name Description
Default

This option is equivalent to the StartsWith option for GridLookUpEdit and TreeListLookUpEdit controls in the following cases:

Otherwise, this option is equivalent to the Contains option for the GridLookUpEdit and TreeListLookUpEdit controls.

This option is equivalent to the StartsWith option for the LookUpEdit control.

This option is equivalent to the Contains option for the SearchLookUpEdit control. Users can use the Find Panel to search for keywords. You can use the ColumnViewOptionsFind.FindFilterColumns property to specify grid columns in which to search for keywords.

Contains

Selects records that contain the specified sub-string.

A search for rows is performed against the column specified by the editor's Properties.DisplayMember property (RepositoryItemLookUpEditBase.DisplayMember).

StartsWith

Selects records whose field values start with the specified string.

A search for rows is performed against the column specified by the editor's Properties.DisplayMember property (RepositoryItemLookUpEditBase.DisplayMember).

Remarks

The PopupFilterMode property sets the rule based on which data records in this LookUpEdit control's popup window are filtered as an end-user enters text to the editor.

  • StartWith and Default modes specify that the editor popup displays only those data records that start with the same character(s) that an end-user entered;

    RepositoryItemLookUpEdit.PopupFilterMode_StartsWith

  • Contains mode specifies that the editor popup displays all data records that contain the character(s) an end-user entered.

    RepositoryItemLookUpEdit.PopupFilterMode_Contains

NOTE

You can choose between StartWith and Contains modes when the RepositoryItemLookUpEditBase.TextEditStyle does not equal TextEditStyles.Standard. Otherwise, the control is limited to the StartWith mode only. Note that this limitation applies only to those look-up editors whose RepositoryItemLookUpEdit.SearchMode property equals AutoComplete.

See Also