由于已添加或删除笔划,因此停止识别器处理墨迹。
Syntax
HRESULT AdviseInkChange(
HRECOCONTEXT hrc,
BOOL bNewStroke
);
参数
hrc
识别器上下文的句柄。
bNewStroke
如果添加新笔划,则为 TRUE。 如果擦除、拆分、合并、提取或删除了 Ink 对象中的笔划,则设置为 FALSE 。
返回值
此函数可以返回其中一个值。
| 返回代码 | Description |
|---|---|
|
成功。 如果识别器不支持此函数,此函数也会返回S_OK。 |
|
其中一个参数是无效的指针。 |
|
发生未指定的错误。 |
|
收到无效参数。 |
注解
AdviseInkChange 函数指示对 AddStroke 函数进行额外调用。 这样,任何正在进行的识别就可以在任何方便的点停止。 识别完成就是这样一点,所以 AdviseInkChange 可以安全地执行任何作。
例如,如果你有两个线程,一个线程可能使用 AddStroke 和 Process 和其他函数来获取结果。 另一个线程可能正在收集墨迹、回显墨迹以及第一个线程的排队任务。 第二个线程调用 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 |