示例 - 字段辅助

简介

字段辅助示例说明如何使用 org.eclipse.jface.fieldassist 提供的支持来在文本字段中提供任务辅助。示例对话框显示了如何设置字段修饰以指示必填字段、有错误和警告的字段以及提供了内容辅助的字段。此示例还提供了一个首选项页,该页允许您配置修饰和内容辅助支持。

运行示例

安装插件后,您在操作栏中应该会看到“字段辅助”操作。请选择菜单项“打开字段辅助对话框...”。这将打开字段辅助对话框。可以使用示例首选项来对此对话框进行配置。

设置字段辅助首选项

提供了两个用于设置对话框行为方式的首选项页。字段辅助示例首选项页允许您配置对话框如何对有错误和警告的字段、必填字段以及内容辅助进行 修饰。可以同时使用颜色和修饰来注释字段。此首选项页旨在说明配置修饰时的可能情况。此示例的目标是促使程序员进一步尝试字段辅助,而不是作为允许最终用户控制注释的首选项页示例。

内容辅助首选项页允许您配置如何在对话框文本字段中安装内容辅助。在此页上,可以配置字段辅助 API(ContentProposalAdapter)中提供的大部分选项。注意,配置内容辅助可能会导致不良的用户体验。例如,不需要将内容辅助设置成以较长的延迟来对所有字符自动激活。未将过滤键传回控件时,使用累积建议过滤会令人困惑。在首选项页中公布 API 的目的是允许字段辅助程序员尝试所有可能的组合。我们并不希望将任何这些首选项透露给最终用户,而是让开发者选择这些值的最佳组合来提供特定样式的内容辅助。

使用对话框

示例对话框显示了几种不同类型的字段:

源代码示例

示例对话框并不非常复杂,它旨在演示如何进行字段辅助编程。下面是一些有关此源代码的说明: