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 プロパティが変更される場合があります。

関数で使用される代替は、文全体で代替語にすることができます。たとえば、"Hello World" に AlternatesFromSelection (0, 5) を使用して取得した代替では、単語の "Hello" 部分のみが変更され、"World" 部分はそのまま残ります。

要件	値
サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll