iInkRecognitionResult：：ModifyTopAlternate 方法 (msinkaut.h)

使用指定的替代專案，變更辨識結果的最上層替代專案。

語法

HRESULT ModifyTopAlternate(
  [in] IInkRecognitionAlternate *Alternate
);

[in] Alternate

要用來修改最上方替代的 IInkRecognitionAlternate 。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
TPC_E_NOT_RELEVANT	Lattice 不包含數據。
E_POINTER	參數包含無效的指標。
E_INVALIDARG	替代專案不符合已知範圍，或未從這個 Lattice 取得。
E_INK_EXCEPTION	處理時發生例外狀況。
E_OUTOFMEMORY	無法配置記憶體來完成作業。

根據預設，辨識結果的最佳結果字串會對應至 頂端替代專案。不過，您可以使用這個方法來指定結果中會使用頂端替代專案以外的替代專案。當您選擇頂端替代專案以外的替代專案時，基本上是透過與結果相關聯的替代項目，選擇不同的路徑。

若要擷取可用來修改辨識結果的替代專案，請呼叫 AlternatesFromSelection 方法。

注意呼叫 ModifyTopAlternate 方法 可能會修改 TopString 和 TopAlternate 屬性。

函式中使用的替代專案可以是整個句子中的替代字。例如，使用 AlternatesFromSelection (0、 5) 取得的替代專案，對於 “Hello World” 只會變更 “World” 部分保留 “World” 部分的 “Hello” 部分。

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	msinkaut.h
程式庫	InkObj.dll