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 函数