iInkRecognitionResult：：ModifyTopAlternate 方法 (msinkaut.h)

使用指定的替代项更改识别结果的顶部替代项。

语法

HRESULT ModifyTopAlternate(
  [in] IInkRecognitionAlternate *Alternate
);

参数

[in] Alternate

用于修改顶部备用的 IInkRecognitionAlternate 。

返回值

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

返回代码	说明
S_OK	成功。
TPC_E_NOT_RELEVANT	格子不包含数据。
E_POINTER	参数包含无效指针。
E_INVALIDARG	备用项与已知范围不匹配，或者不是从此格子中获取的。
E_INK_EXCEPTION	处理时发生异常。
E_OUTOFMEMORY	无法分配内存来完成操作。

注解

默认情况下，识别结果的最佳结果字符串对应于 顶部的备用项。 但是，可以使用此方法指定在结果中使用除顶部备用之外的其他替代项。 如果选择顶部替代项以外的其他替代项，实质上是通过与结果关联的备用项的格选择不同的路径。

若要检索可用于修改识别结果的备用项，请调用 AlternatesFromSelection 方法。

注意 调用 ModifyTopAlternate 方法 可能会修改 TopString 和 TopAlternate 属性。

 

函数中使用的备用函数可以是整个句子中的单词替代项。 例如，使用 AlternatesFromSelection (0、5) 获取的“Hello World”的备用项仅更改单词的“Hello”部分，使“World”部分保持不变。

要求

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

另请参阅

GetAlternatesFromSelection 方法

IInkRecognitionAlternate 接口

IInkRecognitionResult 接口

TopAlternate 属性

TopString 属性