RecognizerContext.EndInkInput メソッド
RecognizerContext オブジェクトへのインク入力を終了します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Sub EndInkInput
'使用
Dim instance As RecognizerContext
instance.EndInkInput()
public void EndInkInput()
public:
void EndInkInput()
public void EndInkInput()
public function EndInkInput()
解説
このメソッドを呼び出した場合は、RecognizerContext オブジェクトに Stroke オブジェクトを追加できません。
部分認識は、すべてのインクが入力されたことをアプリケーションに通知する EndInkInput メソッドをアプリケーションが呼び出していない場合でも結果を返すための認識エンジンの機能です。部分認識は、EndInkInput を呼び出す前に、インクが入力されていることを認識エンジンが確認できる場合にのみ発生します。ただし、この機能をサポートしない認識エンジンもあります。部分認識をサポートしない認識エンジンは、EndInkInput を呼び出すまでは結果を返しません。
増分認識は、渡されたインクの小さな一部分のみを処理して結果を返すための認識エンジンの機能です。たとえば、アプリケーションが 5 行のインクを含み、ラテン スクリプトの認識エンジンを使用する場合を考えます。認識エンジンは一度に 1 行だけを処理して結果を返すことができます。このプロセスは、スレッドを処理するバックグラウンドのアイドル状態のループで使用されます。
認識エンジンが部分認識をサポートする場合は、EndInkInput メソッドが呼び出されていない場合でも結果を返すことができます。
.gif "メモ") メモ : |
|---|
部分認識から取得する結果は、EndInkInput を呼び出す場合の結果と異なる場合があります。部分認識の使用によって、認識エンジンはインクのすべての結果を返す必要がありません。一部のインクの周囲のコンテキストを失うと、認識に悪影響を及ぼす場合があります。 |
| メモ : |
|---|
Windows Vista 以降のリリースでは、西洋言語の認識エンジンでのこのメソッドの使用は推奨されていません。 |
例
この C# の例では、ボタン コントロールの Click イベント buttonSubmit_Click のイベント ハンドラを示します。このイベント ハンドラは、(スコープ内で宣言されている) RecognizerContext、theRecognizerContext に割り当てられた Strokes コレクションで、有効なインクを認識し、エラーがなければテキスト ボックスに結果を表示します。
private void buttonSubmit_Click(object sender, System.EventArgs e)
{
theRecognizerContext.EndInkInput();
RecognitionStatus theRecognitionStatus;
theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
if (RecognitionStatus.NoError == theRecognitionStatus)
theTextBox.Text = theRecognitionResult.TopString;
else
// Handle the error cases here...
theTextBox.Text = "";
}
この Microsoft Visual Basic® .NET の例では、ボタン コントロールの Click イベント buttonSubmit_Click のイベント ハンドラを示します。このイベント ハンドラは、(スコープ内で宣言されている) RecognizerContext、theRecognizerContext に割り当てられた Strokes コレクションで、有効なインクを認識し、エラーがなければテキスト ボックスに結果を表示します。
Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
theRecognizerContext.EndInkInput()
Dim theRecognitionStatus As RecognitionStatus
theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
If RecognitionStatus.NoError = theRecognitionStatus Then
RichTextBox1.Text = theRecognitionResult.TopString
Else
'Handle the error conditions here.
RichTextBox1.Text = ""
End If
End Sub
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0