通过

SetTextContext 函数 （recapis.h）

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

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

Syntax

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

参数

hrc

识别器上下文的句柄。

cwcBefore

pwcBefore 中的字符数。

pwcBefore

在识别器上下文中包含的文本之前的文本字符串。 字符串未终止 NULL 。

cwcAfter

pwcAfter 中的字符数。

pwcAfter

在识别器上下文中包含的文本之后的文本字符串。 字符串不是 NULL -terminated。

返回值

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

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

注解

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

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

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

要求

Requirement 价值
最低支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
支持的最低服务器 无受支持的版本
目标平台 Windows操作系统
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll
  • Last updated on