RepositoryItemTreeListLookUpEdit.PopupFilterMode Property
Gets or sets how records in the dropdown window are filtered when typing text within the edit box.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraTreeList.v24.2.dll
NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList
#Declaration
[DefaultValue(PopupFilterMode.Default)]
[DXCategory("Data")]
public PopupFilterMode PopupFilterMode { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Popup |
Default | A Popup |
Available values:
Name | Description |
---|---|
Default | This option is equivalent to the Starts 1) users cannot edit text in the text box (Repository 2) users can edit text in the text box and the control automatically completes the entered text (Repository Otherwise, this option is equivalent to the Contains option for the Grid This option is equivalent to the Starts This option is equivalent to the Contains option for the Search |
Contains | Selects records that contain the specified sub-string. A search for rows is performed against the column specified by the editor’s Properties. |
Starts |
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. |
#Remarks
The TreeListLookUpEdit control supports record filtering, where typing text within the edit box displays only those records in the dropdown that meet the current criteria. The PopupFilterMode property specifies how records are filtered, using the StartsWith or Contains filter. The StartsWith filter selects records whose values of the DisplayMember field start with the typed text. The Contains filter selects records that contain the typed text within the DisplayMember field.
For the TreeListLookUpEdit control, if text editing is disabled via the RepositoryItemLookUpEditBase.TextEditStyle property, the StartsWith filter is always applied, and changing the PopupFilterMode property is not in effect.
If the PopupFilterMode property is set to Default, the filtering behavior is different for different editors, and is also dependent upon the editor’s settings. See PopupFilterMode.Default to learn more.