getEnabledUnicodeRanges 函数 (recapis.h)

检索在上下文上启用的 Unicode 点范围的列表。 如果不调用 SetEnabledUnicodeRanges 函数来指定启用的范围,此函数将返回识别器的默认 Unicode 点范围。

语法

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

参数

hrc

识别器上下文的句柄。

pcRanges

输入时,pcr 缓冲区可以包含CHARACTER_RANGE结构的数量。 输出时, 是 pcr 缓冲区包含的范围数。

pcr

CHARACTER_RANGE 结构的数组。 每个结构都包含在上下文上启用的 Unicode 点范围。 数组的顺序是任意的。 若要确定缓冲区的大小,请将 pcr 设置为 NULL;使用范围数来分配 pcr 缓冲区。

返回值

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

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

注解

此函数是可选的。

某些识别器不支持启用和禁用特定的 Unicode 点,但可能仍包含 GetEnabledUnicodeRanges 函数。 对于此类识别器, GetEnabledUnicodeRanges 函数返回与 GetUnicodeRanges 函数相同的范围。

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

要求

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

另请参阅

CHARACTER_RANGE 结构

GetUnicodeRanges 函数

SetEnabledUnicodeRanges 函数