跳转到主要内容
Visual Components 在 Windows 版 FRE 中实现。
TextValidator 对象是一个 ActiveX 控件,可用于验证文档中识别不确定的字符。文档通过 FRDocument 属性连接到该组件。 Text Validator 组件可能如下所示: TextValidator 对于纵向书写的文本:
TextValidator_CJK
要开始拼写检查,应调用 TextValidator 对象的 SpellSpellBlock 方法。如果拼写检查已在进行中,需要先将其停止,否则随后对这些方法的调用会被忽略。
  • 您也可以使用 Text Editor 中的 Check Spelling 按钮来开始拼写检查。
  • 某些复杂文字语言 (例如中文、泰语、亚美尼亚语) 中的部分字符,可能无法在 Text Validator 中显示,因为 Text Validator 使用的字体不包含相应字符。在这种情况下,您可以在选项对话框中指定另一种字体 (在 Text Validator 中单击 Settings > Options,转到 View 选项卡,然后在 Font used to display plain text 下拉列表中选择字体) 。
拼写检查信息通过专用的输出接口提供。这些接口包括 ITextValidatorEvents (用于 C++) 和 dispinterface DITextValidatorEvents (用于 Visual Basic) 。 需要注意的是,Visual Basic 用户无需关心事件接口实现的细节,因为该开发平台提供了便捷的处理方式。此对象可以在 Visual Basic 中声明为 WithEvents。 对于 C++ 用户,这意味着它支持 IConnectionPointContainer 接口。要接收通知事件,C++ 用户应创建一个派生自 ITextValidatorEvents 接口的对象,然后通过标准 COM 方法,在该对象与 TextValidator 对象中实现的事件源之间建立连接。 Text Validator 组件可连接到 Component Synchronizer 组件。在这种情况下,Text Validator 中的所有事件都会自动传递给连接到 Synchronizer 的其他组件,整个应用程序将同步运行。

属性

,read-only

表示用户在拼写检查期间添加到字典中的单词集合。

如果在拼写检查期间将单词添加到字典中,则用户字典将创建在以下属性所指定的文件夹中:ILanguageDatabase::DictionaryExtensionsPathproperty.

表示单词对的集合。对中的第一个单词是拼写检查期间被自动替换的源词,第二个单词是替换词。

指定 Text Validator 是否在拼写检查期间更正空格。如果将此属性的值设置为 TRUE,Text Validator 将更正标点符号前后的空格。

默认值为 FALSE。

表示拼写检查期间应被忽略的单词集合。

, read-only

指定拼写检查是否正在进行。

表示与 Text Validator 关联的文档。

指定 Text Validator 是否处于锁定状态。

此属性在以下情况下适用:

  • 从 FineReader Engine API (而非 Visual Components) 调用了分析、识别、合成或导出操作,或
  • 应用程序收到某些事件的通知 (例如,来自对象) ,并在这些事件处理程序中处理来自 Visual Components 的 Windows 消息。

在这种情况下,建议在执行分析、识别、合成或导出操作之前将此属性设置为 TRUE,操作完成后再将其设置为 FALSE。这样可以防止文档被 Text Validator 损坏。

默认值为 FALSE。

表示单词对的集合。对中的第一个单词是拼写检查期间被替换的源词,第二个单词是替换词。

指定包含 Text Validator 设置文件的文件夹路径。其他 Visual Components 具有相同的属性。每个 Visual Component 应使用各自独立的设置文件夹。

此属性的值由 ABBYY FineReader Engine 存储用户专属数据的文件夹路径及其子文件夹名称组合而成。默认情况下,该用户专属数据文件夹为FineReader Engine data folder。可在 FineReader Engine 初始化期间 (通过function, or via the方法) 。子文件夹的默认名称为随机 GUID。若要更改子文件夹的名称,需在设计时于 Visual Studio 的组件属性中指定新名称。如果尝试在运行时指定属性值,该值将被忽略。

如果在设计时将组件添加到 Visual Studio 的窗体中,属性值将自动采用默认值,或由用户手动指定自定义值。两种情况下,值均在设计时确定。如果由于某种原因属性值未在设计时定义 (例如在运行时动态生成组件) ,则每次初始化组件时,组件都会创建一个新的设置文件夹。为避免文件夹数量持续增加,应在组件反初始化后删除已创建的设置文件夹。在这种情况下,只能使用组件的默认设置,且无法在会话之间保存设置。

指定 Text Validator 在拼写检查期间是否在复合词处停止。

默认值为 FALSE。

指定 Text Validator 在拼写检查期间是否在无意义字符处停止。无意义字符是指没有实际含义的字符组合。

默认值为 FALSE。

指定 Text Validator 在拼写检查期间是否在字典中未找到的词语处停止。此属性与 StopAtUncertain 属性不能同时设置为 FALSE。

默认值为 TRUE。

指定 Text Validator 在拼写检查期间是否在识别置信度较低的字符处停止。此属性与 StopAtNonDictionary 属性不能同时设置为 FALSE。

默认值为 TRUE。

,只读

表示拼写检查期间为纠正识别置信度较低的词语拼写而建议的候选词集合。

指定文档的默认合成参数。当 Text Validator 需要执行文档合成时将使用这些参数 (若某些编辑操作导致文档逻辑结构出现错误,则可能触发文档合成) 。

如果 Text Validator 已连接到 Component Synchronizer,请使用IComponentSynchronizer::ProcessingParams属性更改用于文档合成的参数。若通过 Text Validator 的属性更改这些参数,可能会导致错误。

,只读

表示识别置信度较低的字符或词语的位置。

,只读

返回客户端区域的窗口句柄。

方法

名称描述
EndSpelling停止拼写检查。
Spell从指定位置开始拼写检查。
SpellBlock检查指定 Block 中的拼写。
UpdateOptions更新在 Text Validator 的“选项”对话框中指定的设置。如果这些选项已在其他 Visual Component 中更改,您可能需要调用此方法,将这些选项更新为当前状态。

示例

此组件用于以下代码示例:VisualComponents

另请参见

ITextValidatorEvents IComponentSynchronizer::TextValidator 创建具有图形用户界面的应用程序