详解DevExpress.LookUpEdit控件实现自动搜索定位功能-开发框架文库

详解DevExpress.LookUpEdit控件实现自动搜索定位功能

标签：

详解DevExpress.LookUpEdit控件实现自动搜索定位功能

详解DevExpress.LookUpEdit控件实现自动搜索定位功能

首先介绍三个重要的属性：

1. LookUpEdit.Properties.ImmediatePopup 在输入框按任一可见字符键时立即弹出下拉窗体。
2. LookUpEdit.Properties.AutoSearchColumnIndex 设置自动搜索的栏位序号，下拉窗体第一个栏位为0,依此类推，此属性配合SearchMode=OnlyInPopup时有效。
3. LookUpEdit.Properties.SearchMode 自动搜索定位模式

贴图图片

关于枚举类型SearchMode的定义：

C# Code:

    // Summary:
    //     Enumerates search modes for a lookup edior.
    public enum SearchMode
    {
        // Summary:
        //     The incremental search is enabled only when the dropdown window is open.
        //     If the window is closed, the user can modify the text in the edit box. However
        //     these changes are ignored.
        //     When the dropdown is open the incremental search is performed against the
        //     column whose index is specified by the DevExpress.XtraEditors.Repository.RepositoryItemLookUpEdit.AutoSearchColumnIndex
        //     property. The header of this column contains the search icon (binoculars).
        //     The user can click a specific column header to perform the search against
        //     this column.
        //     The following screenshot shows a sample lookup editor. The incremental search
        //     is performed against the second column.
        OnlyInPopup = 0,
        //
        // Summary:
        //     Enables the automatic completion feature. In this mode, when the dropdown
        //     is closed, the text in the edit box is automatically completed if it matches
        //     a DevExpress.XtraEditors.Repository.RepositoryItemLookUpEditBase.DisplayMember
        //     field value of one of dropdown rows.
        //     When the dropdown is open, the automatic completion feature is disabled but
        //     the editor allows you to perform an incremental search in the same manner
        //     as when DevExpress.XtraEditors.Controls.SearchMode.OnlyInPopup mode is active.
        AutoComplete = 1,
        //
        // Summary:
        //     Enables the incremental filtering feature. When you type within the edit
        //     box, the editor automatically opens the dropdown window and displays only
        //     records whose DevExpress.XtraEditors.Repository.RepositoryItemLookUpEditBase.DisplayMember
        //     field value starts with the characters typed. Other records are not displayed.
        //     If you enter a value that does not match any record, the dropdown window
        //     will not contain any rows.
        //     The following image shows a lookup editor when AutoFilter mode is enabled.
        AutoFilter = 2,
    }

//来源:C/S框架网(www.csframework.com) QQ:1980854898

OnlyInPopup : 配合ImmediatePopup=True时使用，当用户在输入框按任一可见字符键时立即弹出下拉窗体，并跟据输入的字符从头部开始匹配AutoSearchColumnIndex属性指定栏位字段的值，第一个栏位为0.

特点：在下拉窗体能显示匹配结果（蓝底白字），但在输入框内不显示。

效果图如下：

贴图图片

AutoComplete: 配合ImmediatePopup=True时使用，当用户在输入框按任一可见字符键时立即弹出下拉窗体，并在输入框自动完成您想要输入的数据，同时下拉窗体自动匹配最佳记录。AutoComplete模式仅匹配DisplayMember对应字段的值。

特点：能在输入框显示匹配的数据，并且下拉窗体显示匹配的记录。

效果图如下：

贴图图片