IInkRecognizerContext::BackgroundRecognizeWithAlternates メソッド (msinkaut.h)

IInkRecognizer オブジェクトが関連付けられた strokes コレクションを認識し、認識が完了したときに 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 タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll

関連項目

BackgroundRecognize メソッド

Data プロパティ

IInkRecognitionAlternate インターフェイス

IInkRecognizerContext

InkRecognizerContext クラス