GetUnicodeRanges 函数 (recapis.h)

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

Syntax

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

参数

hrec

识别器的句柄。

pcRanges

在输入时, 缓冲器 可以保存的范围数。 在输出中, 对于其包含的rf 缓冲区所包含的范围数。

pcr

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

返回值

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

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

注解

此函数是可选的。

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

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

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

要求

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

另请参阅

GetEnabledUnicodeRanges 函数

SetEnabledUnicodeRanges 函数