setTextContext 函数 (recapis.h)

  • 项目

提供识别器上下文中包含的文本之前和之后的文本字符串。

在首次处理墨迹之前调用此函数。 因此，在调用 Process 函数之前调用 SetTextContext 函数。

语法

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

parameters

hrc

识别器上下文的句柄。

cwcBefore

pwcBefore 中的字符数。

pwcBefore

位于识别器上下文中包含的文本之前的文本字符串。 字符串不以 NULL 结尾。

cwcAfter

pwcAfter 中的字符数。

pwcAfter

识别器上下文中包含的文本后面的文本字符串。 字符串不以 NULL 结尾。

返回值

此函数可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_POINTER
 上下文无效或其中一个参数为无效指针。
E_NOTIMPL
 识别器不支持此函数。
E_OUTOFMEMORY
 无法分配内存来完成操作。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 指定的参数无效。

备注

SetTextContext 函数为短语或单词提供上下文，从而提高识别器的准确性。 例如，如果 pwcBeforepwcBefore 字符串为“under”，而 pwcAfter 字符串为“in the house”，则可以在字符串之间使用一个或多个单词来偏置识别器。 在执行识别时，识别器应考虑“”后和“in”之前的空格。

但是，如果 pwcAfter 字符串为“Hel”， pwcBefore 字符串为“o”，则字符串之间缺少空格表示识别器应识别以“Hel”开头、以“o”结尾的单词中的一个或多个字母。

对于左右上下文，建议将文本上下文的长度限制为不超过 1024 个字符。

要求

   
最低受支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 recapis.h
DLL inkobjcore.dll