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 [仅限桌面应用] |
| 最低受支持的服务器 |
无受支持的版本 |
| 标头 |
|