AdviseInkChange 函数 (recapis.h)

由于已添加或删除笔划,因此停止识别器处理墨迹。

Syntax

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

参数

hrc

识别器上下文的句柄。

bNewStroke

如果添加新笔划,则为 TRUE。 如果擦除、拆分、合并、提取或删除了 Ink 对象中的笔划,则设置为 FALSE

返回值

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

返回代码 Description
S_OK
成功。 如果识别器不支持此函数,此函数也会返回S_OK。
E_POINTER
其中一个参数是无效的指针。
E_FAIL
发生未指定的错误。
E_INVALIDARG
收到无效参数。

注解

AdviseInkChange 函数指示对 AddStroke 函数进行额外调用。 这样,任何正在进行的识别就可以在任何方便的点停止。 识别完成就是这样一点,所以 AdviseInkChange 可以安全地执行任何作。

例如,如果你有两个线程,一个线程可能使用 AddStrokeProcess 和其他函数来获取结果。 另一个线程可能正在收集墨迹、回显墨迹以及第一个线程的排队任务。 第二个线程调用 AdviseInkChange 来通知识别器即将发生更改。 这样,第一个线程就可以在调用 AdviseInkChange 之后更快地返回调用。 然后,第一个线程可以使用更多墨迹再次调用识别器。

如果将 bNewStroke 参数设置为 FALSE ,因为笔划已修改或删除,则还必须调用 ResetContext 函数,然后调用 AddStroke 函数,将 InkDisp 对象中的笔划添加到识别器上下文。 如果将识别器上下文附加到 InkDisp 对象,则会自动执行此作。

要求

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