InkRecognizerContext 类

启用执行墨迹识别、检索识别结果和检索备用项的能力。 InkRecognizerContext 使系统上安装的各种识别器能够使用墨迹识别来适当处理输入。

InkRecognizerContext 具有以下类型的成员:

事件

InkRecognizerContext 类具有这些事件。

事件 说明
识别 当 InkRecognizerContext 从 BackgroundRecognize 方法生成结果时发生。
RecognitionWithAlternates InkRecognizerContext 在调用 BackgroundRecognizeWithAlternates 方法后生成结果时发生

接口

InkRecognizerContext 类定义这些接口。

接口 说明
IInkRecognizerContext 此对象实现 IInkRecognizerContext COM 接口。

方法

InkRecognizerContext 类具有这些方法。

方法 说明
BackgroundRecognize 指定识别器应识别关联的笔画,在识别完成时,应会发一个 Recognition 事件。
BackgroundRecognizeWithAlternates 指定识别器应识别关联的笔画,在识别完成时,将 Fire a RecognitionWithAlternates 事件。
克隆 创建重复的 InkRecognizerContext
EndInkInput 结束 InkRecognizerContext 的墨迹输入。
IsStringSupported 指示系统字典、用户字典或 单词列表是否包含 指定的字符串。
Recognize InkStrokes 集合 执行识别并返回识别结果。
StopBackgroundRecognition 结束通过调用 BackgroundRecognizeBackgroundRecognizeWithAlternates 启动的背景识别

属性

InkRecognizerContext 类具有这些属性。

属性 访问类型 说明
CharacterAutoCompletion
读取/写入
获取或设置字符自动完成模式,该模式确定何时识别字符或单词。
Factoid
读取/写入
获取或设置 InkRecognizerContext 对象使用的 factoid 的字符串名称。
指南
读取/写入
获取或设置 用于墨迹输入的 InkRecognizerGuide。
PrefixText
读取/写入
获取或设置 InkRecognizerContext 对象 中 InkStrokes集合之前的字符。
RecognitionFlags
读取/写入
获取或设置标志,这些标志指定识别器如何解释墨迹并确定结果字符串。
识别
读取/写入
获取或设置 InkRecognizerContext 对象使用的 IInkRecognizer对象。
中风
读取/写入
获取或设置与 InkRecognizerContext 对象关联的 InkStrokes集合。
SuffixText
读取/写入
获取或设置 InkRecognizerContext 对象 中 InkStrokes集合之后的字符。
WordList
读取/写入
获取或设置用于改进识别结果的 InkWordList 对象。

备注

可以通过在 C++ 中调用 CoCreateInstance 方法来实例化此对象。

有两种类型的识别:后台 (异步) 或 (同步) 。 后台识别是通过调用 BackgroundRecognizeBackgroundRecognizeWithAlternates 方法启动的,在后台线程上发生,并通过事件机制向应用程序报告结果。 前台识别在所有识别完成之前不会返回,从而使识别结果可用于调用线程,而无需侦听识别事件。

墨迹在后台连续处理。 如果将 IInkStrokeDisp添加到 InkRecognizerContext 引用的 InkStrokes集合中,则随后将立即识别 IInkStrokeDisp。 有关详细信息,请参阅 EndInkInput 方法主题中的备注。

所有识别都通过识别器上下文进行。 上下文定义单个识别会话的设置。 它接收必须识别的墨迹,并定义墨迹输入和识别输出的约束。 可以在上下文中设置的约束包括所使用的语言、字典和语法。

备注

只有在 InkStrokes集合为 NULL 时,设置 StrokesCharacterAutoCompletion属性外的属性才 成功。 在将 InkStrokes 集合附加到 InkRecognizerContext 之前,必须设置其他属性,或者必须将 InkStrokes 集合设置为 NULL, 然后设置其他属性。 如果将 InkStrokes 集合设置为 NULL, 然后设置其他属性,可能需要重新附加 InkStrokes 集合。 这是因为在将 InkStrokes 分配给 InkRecognizerContext 之后,识别就会开始。 调用 Recognize 方法 [ InkRecognizeContext ] 类BackgroundRecognize时,调用结果可能已经存在。

若要提高应用程序的性能,请释放 不再需要的 InkRecognizerContext 对象。

要求

要求
最低受支持的客户端
Windows仅 XP Tablet PC Edition [ 桌面应用]
最低受支持的服务器
无受支持的版本
标头
Msinkaut (还要求 Msinkaut _)

InkObj.dll

另请参阅

IInkRecognizer 接口

InkStrokes 集合