HRECOCONTEXT 句柄

HRECOCONTEXT 句柄用于向上下文添加墨迹、 (同步或异步) 执行墨迹识别、检索识别结果以及检索替换项。

使用识别器上下文句柄的主要原因是区分墨迹输入。 例如，可以创建一个具有两个窗口的应用程序，即用户能够在任一窗口中墨迹书写。 当你要求识别器识别其中一个窗口的墨迹时，不希望第一个窗口的墨迹与第二个窗口的墨迹混合在一起。 在此类应用程序中，为每个窗口创建两个识别器上下文 (一个) ，并将进入窗口 1 的笔划添加到识别器上下文 1 中，将窗口 2 中的笔划添加到识别器上下文 2 中。 若要返回识别结果，请在识别器上下文 1 或识别器上下文 2 上调用进程，具体取决于是希望窗口 1 还是窗口 2 的结果。

识别器上下文句柄可以是所需的任何内容。 但它通常是结构全局数组中的索引。 结构可能包含已输入的所有笔划，以及识别器用于该特定墨迹的所有变量 (例如，内部晶格结构或识别) 的当前状态。 一个结构可能包含识别器需要和用于一个特定墨迹片的所有信息。

若要获取 HRECOCONTEXT 句柄，请调用 CreateContext 函数。

typedef HANDLE HRECOCONTEXT;

备注

以下是 HRECOCONTEXT 函数

函数	说明
AddStroke	将墨迹笔划添加到识别器上下文。
AdviseInkChange	停止识别器处理墨迹，因为正在添加或删除新笔划。
CloneContext	创建一个识别器上下文，其中包含与原始设置相同的设置。 新的识别器上下文不包括原始的墨迹或识别结果。
EndInkInput	指示不再向上下文添加墨迹。
GetAlternateList	返回最佳结果字符串的替换项列表。
GetBestAlternate	返回一个 HRECOALT 句柄 指针，以获取最佳结果备用。
GetBestResultString	返回最佳结果字符串。
GetContextPropertyList	返回识别器支持的属性列表。
GetContextPropertyValue	从识别器上下文返回指定的属性值。
GetEnabledUnicodeRanges	返回在上下文上启用的 Unicode 点范围的列表。
GetGuide	返回用于装箱输入或内线输入的参考线。
GetLatticePtr	返回指向当前结果的格子的指针。
IsStringSupported	返回一个值，该值指示字典中是否包含传入的单词、日期、时间、数字或其他文本。
进程	同步执行墨迹识别。
ResetContext	从上下文中删除当前墨迹和识别结果。
SetCACMode	指定字符或单词识别的字符自动完成模式。
SetContextPropertyValue	将属性添加到识别器上下文。 如果属性已存在，则修改其值。
SetEnabledUnicodeRanges	在上下文中启用一个或多个 Unicode 点范围。
SetFactoid	设置识别器用于限制其对结果的搜索的事实。
SetFlags	设置识别器如何解释墨迹并确定结果字符串。
SetGuide	设置用于装箱输入或内线输入的参考线。
SetTextContext	提供识别器上下文中包含的文本之前和之后的文本字符串。 对于东亚字符的识别器， SetTextContext 函数提供字符而不是文本字符串。
SetWordList	设置要识别的当前识别器上下文的单词列表。

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	Recapis.h