SetEnabledUnicodeRanges 函数 (recapis.h)

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

Syntax

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

参数

hrc

识别器上下文的句柄。

cRanges

pRanges 缓冲区中的范围数。

pcr

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

返回值

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

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

注解

SetEnabledUnicodeRanges 函数是可选的。

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

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

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

要求

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

另请参阅

CHARACTER_RANGE结构

GetEnabledUnicodeRanges 函数

GetUnicodeRanges 函数