RecognizerContext.Recognize 方法

發行項
10/29/2008

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'用途
Dim instance As RecognizerContext
Dim recognitionStatus As RecognitionStatus
Dim returnValue As RecognitionResult

returnValue = instance.Recognize(recognitionStatus)

public RecognitionResult Recognize(
    out RecognitionStatus recognitionStatus
)

public:
RecognitionResult^ Recognize(
    [OutAttribute] RecognitionStatus% recognitionStatus
)

public RecognitionResult Recognize(
    /** @attribute OutAttribute */ /** @ref */RecognitionStatus recognitionStatus
)

public function Recognize(
    recognitionStatus : RecognitionStatus
) : RecognitionResult

參數

recognitionStatus
型別：Microsoft.Ink.RecognitionStatus%
RecognitionStatus 列舉型別的成員，表示是否有在辨識期間發生錯誤，如果有的話，發生的錯誤為何。

傳回值

型別：Microsoft.Ink.RecognitionResult
所辨識 Strokes 集合的 RecognitionResult 物件。

備註

如果辨識器無法計算 Strokes 集合的結果，則這個方法會傳回 null (在 Microsoft® Visual Basic® .NET 中為 Nothing)。

注意事項：
您必須在呼叫 Recognize 方法時使用 try/catch 區塊，因為當 Ink 物件沒有包含筆劃時會擲回例外狀況。

這個方法會以同步方式執行辨識。若要啟動背景 (或稱非同步) 辨識，請呼叫 BackgroundRecognize 或 BackgroundRecognizeWithAlternates 方法。

範例

這個 C# 範例所顯示之 Button 控制項 Click 事件 (buttonSubmit_Click) 的事件處理常式，會辨識其在包含範圍中宣告之 RecognizerContext 物件 (theRecognizerContext) 中的筆墨。範例接著會在沒有錯誤的情況下，於 TextBox 控制項中顯示 RecognitionResult 物件 (theRecognitionResult)。

private void buttonSubmit_Click(object sender, System.EventArgs e)
{
    RecognitionStatus theRecognitionStatus;
    theRecognizerContext.EndInkInput();
    try
    {
      theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
      if (RecognitionStatus.NoError == theRecognitionStatus)
      {
        theTextBox.Text = theRecognitionResult.TopString;
      }
      else
      {
         theTextBox.Text = "";
      }
    }
    catch
    {
      // If Ink object in theRecognizerContext contains no strokes or only
      // deleted strokes, exception is thrown.
      theTextBox.Text = "";
    }
}

這個 Microsoft® Visual Basic® .NET 範例所顯示之 Button 控制項 Click 事件 (buttonSubmit_Click) 的事件處理常式，會辨識其在包含範圍中宣告之 RecognizerContext 物件 (theRecognizerContext) 中的筆墨。範例接著會在沒有錯誤的情況下，於 TextBox 控制項中顯示 RecognitionResult 物件 (theRecognitionResult)。

Private Sub Button1_Click( ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles Button1.Click
    theRecognizerContext.EndInkInput()
    Dim theRecognitionStatus As RecognitionStatus
    Try
        theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
        If RecognitionStatus.NoError = theRecognitionStatus Then
            RichTextBox1.Text = theRecognitionResult.TopString
        Else
            'Handle the error conditions here.
            RichTextBox1.Text = ""
        End If
    Catch
        ' If Ink object in theRecognizerContext contains no strokes or only
        ' deleted strokes, exception is thrown.
        RichTextBox1.Text = ""
    End Try
End Sub