IInkRecognizerContext::BackgroundRecognizeWithAlternates 方法 (msinkaut.h)

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

语法

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

参数

[in, optional] CustomData

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

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

返回值

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

HRESULT 值 说明
S_OK
成功。
E_OUTOFMEMORY
无法分配内存以完成操作。
E_INK_NO_STROKES_TO_RECOGNIZE
不存在笔划。
E_INK_EXCEPTION
方法内发生异常。

注解

此方法指定以异步方式执行墨迹识别。

若要执行仅包含最佳结果字符串且不包含替代项的识别,请调用 BackgroundRecognize 方法。

如果识别器无法识别任何备用项,则不会引发 RecognitionWithAlternates 事件。

要求

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

请参阅

BackgroundRecognize 方法

Data 属性

IInkRecognitionAlternate 接口

IInkRecognizerContext

InkRecognizerContext 类