[Winforms使用技巧教程]查找编辑器-自动建议

AABBbaby

下载DevExpress v19.2完整版

DevExpress Winforms Controls 内置140多个UI控件和库，完美构建流畅、美观且易于使用的应用程序。在本文中，小编将为大家介绍WinForms Lookup Editors控件的一些功能，并说明如何为下一个WinForms项目选择适当的WinForms查找。

已发布的v19.2版本将为LookUpEdit和GridLookupEdit控件（自动建议）包含一个很棒的新功能。 在解释此新功能之前，现将其与现有的自动完成模式区分开，可以使用组件的SearchMode属性启用自动完成功能。处于激活状态时，自动完成功能将强制绑定查询编辑器查找与用户输入的文本匹配的记录，并显示其在查询中找到的第一项：

要激活自动建议，您需要将SearchMode设置为AutoSuggest。 与AutoComplete（在数据绑定的查找中隐藏不匹配的记录）不同，AutoSuggest在用户输入文本时动态更改编辑器的数据源（因此，它可以与完全空的、未绑定的编辑器一起使用）。

每次用户输入新字符时，查找编辑器都会触发AutoSuggest事件。 必须处理此事件并为其分配一个自定义的System.Threading.Tasks.Task对象。 此异步可取消任务必须返回记录的集合，这些记录将被视为编辑器源。

[C#] 纯文本查看 复制代码

lookUpEdit1.AutoSuggest += OnAutoSuggest;

void OnAutoSuggest(object sender, LookUpEditAutoSuggestEventArgs e) { 
// Set delay (if needed) 
e.SetMinimumAnimationDuration(TimeSpan.FromMilliseconds(1000)); 
// Assign a Task that return suggestions 
e.QuerySuggestions = WorldCities.QueryAsync(e.Text, e.CancellationToken); 
}

实施Task的方式完全取决于您：在演示中，将解析一个巨大的本地存储的Excel文件。 您可以从数据库文件检索数据，也可以发送SQL查询并从远程服务器检索记录。

当查找获得下拉项目时，编辑器将扫描这些记录并突出显示与用户文本匹配的项目标题的所有部分。 此默认逻辑涵盖了许多简单的场景，但是如果需要，您可以自由实施自定义突出显示模式。

在演示中，“Enter the city name” 查找由一个任务填充，该任务搜索城市和州名称中的匹配项。 但是，查找记录也包含国家/地区名称。 默认的突出显示模式不适合这样的情况，因为它突出显示了国家名称中的字符（Task忽略了这些字符）。

要解决此不匹配问题，将自定义方法分配给SetHighlightRanges事件参数。

[C#] 纯文本查看 复制代码

void OnAutoSuggest(object sender, LookUpEditAutoSuggestEventArgs e) { 
//... 
// Set Custom Highlight Strategy
e.SetHighlightRanges(HighlightTags(e.Text)); 
}

DevExpress v19.2全新发布，欢迎下载最新版体验哦~

DevExpress技术交流群：540330292      欢迎一起进群讨论

66767376

gridlookup AutoSuggest 事件 输入时连续多次触发 而 CancellationToken 未做取消标识，这是BUG吗?