getUnicodeRanges 函数 (recapis.h)

返回识别器支持的 Unicode 点的范围。

语法

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

参数

hrec

识别器的句柄。

pcRanges

输入时, pcr 缓冲区可以容纳的范围数。 输出时, pcr 缓冲区包含的范围数。

pcr

CHARACTER_RANGE结构的数组。 每个结构都包含识别器支持的 Unicode 点范围。 数组的顺序是任意的。 若要确定所需的缓冲区大小,请将 pcr 设置为 NULL;使用范围数来分配 pcr 缓冲区。

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
其中一个参数是无效的指针。
TPC_E_INSUFFICIENT_BUFFER
pcr 缓冲区太小。
E_FAIL
发生了未指定的错误。
E_INVALIDARG
收到无效参数。
E_OUTOFMEMORY
内存不足。

注解

此函数是可选的。

某些识别器不支持此功能,但仍可能包含 GetUnicodeRanges 函数 。 对于此类识别器, GetUnicodeRanges 函数返回E_NOTIMPL。

若要控制特定识别器上下文使用的 Unicode 范围,请使用 GetEnabledUnicodeRangesSetEnabledUnicodeRanges 函数。 这些范围被限制为 GetUnicodeRanges 返回的范围的子集。

Microsoft 手势识别器使用从0xF000到0xF0FF的 Unicode 字符。 此范围中的每个 Unicode 值都表示一个手势。 有关手势的 Unicode 值的完整列表,请参阅 手势的 Unicode 范围值

要求

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

另请参阅

GetEnabledUnicodeRanges 函数

SetEnabledUnicodeRanges 函数