iInkRecognizerContext::BackgroundRecognize 方法 (msinkaut.h)

使 IInkRecognizer 对象识别关联的笔划集合,并在识别完成后触发 识别 事件。

语法

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

参数

[in, optional] CustomData

指定 在 Recognition 事件中可供应用程序使用的任何应用程序定义数据。 此参数可以是类型为 VT_EMPTY 或 VT_NULL 类型的 VARIANT(如果不需要传递数据)。 默认值为 NULL。

有关 VARIANT 结构的详细信息,请参阅 使用 COM 库

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
成功。
E_OUTOFMEMORY
无法分配内存来完成操作。
E_INK_NO_STROKES_TO_RECOGNIZE
不存在笔划。
E_INK_EXCEPTION
方法内发生异常。

注解

此方法指定以异步方式执行墨迹识别。 若要同步识别墨迹,请调用 Recognize 方法。

此方法仅识别最佳结果字符串。 不创建备用项。 若要执行创建可用备用项列表的识别,请调用 BackgroundRecognizeWithAlternates 方法。

如果 识别 器无法识别任何内容,则不会引发识别事件。

要求

要求
最低受支持的客户端 Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 msinkaut.h
Library InkObj.dll

另请参阅

BackgroundRecognizeWithAlternates 方法

Data 属性

IInkRecognitionAlternate 接口

IInkRecognizerContext

InkRecognizerContext 类