RecognizerContext.Recognize-Methode

Artikel
11/26/2008

Gibt ein RecognitionResult-Objekt für eine Strokes-Auflistung zurück.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'Usage
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

Parameter

recognitionStatus
Typ: Microsoft.Ink.RecognitionStatus%
Ein Element der RecognitionStatus-Enumeration, das angibt, ob während der Erkennung ein Fehler aufgetreten ist und falls ja welcher Fehler.

Rückgabewert

Typ: Microsoft.Ink.RecognitionResult
Das RecognitionResult-Objekt für eine erkannte Strokes-Auflistung.

Hinweise

Diese Methode gibt NULL (Nothing in Microsoft® Visual Basic® .NET) zurück, wenn das Erkennungsmodul kein Ergebnis für die Strokes-Auflistung berechnen kann.

Hinweis

Sie müssen den Aufruf der Recognize-Methode in einen try/catch-Block einfügen, weil eine Ausnahme ausgelöst wird, wenn das Ink-Objekt keine Striche enthält.

Diese Methode führt die Erkennung synchron aus. Um eine Hintergrunderkennung bzw. asynchrone Erkennung zu starten, rufen Sie die BackgroundRecognize-Methode oder die BackgroundRecognizeWithAlternates-Methode auf.

Beispiele

In diesem C#-Beispiel wird der buttonSubmit_Click-Ereignishandler für das Click-Ereignis eines Button-Steuerelements veranschaulicht, der die Freihandeingaben in dem ihm zugeordneten RecognizerContext-Objekt theRecognizerContext erkennt, das in dem Bereich deklariert wird, der es enthält. Im Beispiel wird das RecognitionResult-Objekt theRecognitionResult dann in einem TextBox-Steuerelement angezeigt, sofern keine Fehler aufgetreten sind.

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 = "";
    }
}

In diesem Microsoft® Visual Basic® .NET-Beispiel wird der buttonSubmit_Click-Ereignishandler für das Click-Ereignis eines Button-Steuerelements veranschaulicht, der die Freihandeingaben in dem ihm zugeordneten RecognizerContext-Objekt theRecognizerContext erkennt, das in dem Bereich deklariert wird, der es enthält. Im Beispiel wird das RecognitionResult-Objekt theRecognitionResult dann in einem TextBox-Steuerelement angezeigt, sofern keine Fehler aufgetreten sind.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.