IInkStrokes::ToString 方法 (msinkaut.h)

[自 Windows Vista 起,ToString 不再可供使用。 相反,请参阅 String 属性,了解 IInkRecognitionAlternate 对象的此方法的等效项。 ]

使默认识别器对笔划集合执行识别,并返回识别结果顶部替换项的顶部字符串。

语法

HRESULT ToString(
  [out, retval] BSTR *ToString
);

参数

[out, retval] ToString

默认识别器对笔划集合执行识别后,IInkRecognitionResult 对象的 TopAlternate 属性的顶部字符串。

有关 BSTR 数据类型的详细信息,请参阅 使用 COM 库

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效的指针。
E_FAIL
操作失败。
E_OUTOFMEMORY
内存不足。
E_INK_EXCEPTION
方法内发生异常。
TPC_E_RECOGNIZER_NOT_REGISTERED
未安装任何识别器、识别器注册表项已损坏或环境不支持手写识别。

注解

不应将 ToString 用于手写识别应用程序;它可用于调试目的。

在如下情况下,ToString 返回 NULL

  • InkStrokes 集合为空。
  • 无法创建默认识别器。
  • 默认识别器不支持免费输入。

要求

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

另请参阅

IInkRecognizer 接口

IInkStrokes

InkStrokes 集合