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 后才会返回结果。

增量识别是识别器的一种功能，使用该功能时，识别器只处理已传递给它的一小部分墨迹并返回结果。例如，假设有一个应用程序包含五行墨迹并使用拉丁语识别器。识别器一次只能处理一行并返回结果。此进程将用在后台处理线程的空闲循环中。

如果识别器支持部分识别，即使尚未调用 EndInkInput 方法，识别器也会返回结果。

备注

使用部分识别时所产生的结果可能不同于调用 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(R) .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

另请参见

参考

RecognizerContext 类

RecognizerContext 成员

Microsoft.Ink 命名空间