SetEnabledUnicodeRanges 函数 (recapis.h)

在上下文中启用一个或多个 Unicode 点范围。

语法

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

parameters

hrc

识别器上下文的句柄。

cRanges

pRanges 缓冲区中的范围数。

pcr

CHARACTER_RANGE 结构的数组。 每个结构标识要在识别器中启用的 Unicode 点范围。 数组的顺序是任意的。

返回值

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

返回代码 说明
S_OK
成功。
TPC_S_TRUNCATED
识别器不支持指定的 Unicode 点范围之一。
E_FAIL
发生了未指定的错误。
E_INVALIDARG
收到无效参数。
E_POINTER
其中一个参数是无效的指针。

备注

SetEnabledUnicodeRanges 函数是可选的。

某些识别器不支持启用和禁用特定码位,但可能仍包含 SetEnabledUnicodeRanges 函数。 对于此类识别器, SetEnabledUnicodeRanges 函数返回E_NOTIMPL。

每个识别器都支持一个或多个 Unicode 点范围。 若要确定识别器支持的 Unicode 点范围,请调用 GetUnicodeRanges 函数。 如果不调用此函数,则识别器将使用一组默认的 Unicode 点范围。 默认范围特定于识别器。

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

要求

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

另请参阅

CHARACTER_RANGE 结构

GetEnabledUnicodeRanges 函数

GetUnicodeRanges 函数