InkEdit.Recognition-Ereignis

Artikel
11/26/2008

Tritt auf, wenn das InkEdit-Steuerelement Erkennungsergebnisse abruft.

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

Syntax

'Declaration
Public Event Recognition As InkEditRecognitionEventHandler
'Usage
Dim instance As InkEdit
Dim handler As InkEditRecognitionEventHandler

AddHandler instance.Recognition, handler

public event InkEditRecognitionEventHandler Recognition

public:
 event InkEditRecognitionEventHandler^ Recognition {
    void add (InkEditRecognitionEventHandler^ value);
    void remove (InkEditRecognitionEventHandler^ value);
}

/** @event */
public void add_Recognition (InkEditRecognitionEventHandler value)
/** @event */
public void remove_Recognition (InkEditRecognitionEventHandler value)

JScript unterstützt keine Ereignisse.

Hinweise

Der Ereignishandler empfängt ein Argument vom Typ InkEditRecognitionEventArgs, das Daten zu diesem Ereignis enthält.

Beim Erstellen eines InkEditRecognitionEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird.

Das InkEdit-Steuerelement ruft Erkennungsergebnisse auf eine von zwei Arten ab:

Manuell aus einem Aufruf der InkEdit.Recognize-Methode.
Automatisch, nachdem der Timeout für die Erkennung ausgelöst wurde.

Beispiele

In diesem Beispiel wird das Recognition-Ereignis verwendet, um das RecognitionResult-Objekt beizubehalten. Zunächst wird das RecognitionResult-Objekt an die zugeordnete Strokes-Auflistung angefügt, indem die SetResultOnStrokes-Methode aufgerufen wird. Anschließend werden der CustomStrokes-Eigenschaft des zugeordneten Ink-Objekts die Strokes hinzugefügt.

Private Sub mInkEdit_Recognition(ByVal sender As Object, ByVal e As InkEditRecognitionEventArgs)
    Dim R As RecognitionResult = e.RecognitionResult
    R.SetResultOnStrokes()
    ' add these strokes to custom strokes collection
    ' using R.Strokes(0).Id as the name
    R.Strokes.Ink.CustomStrokes.Add(R.Strokes(0).Id.ToString(), R.Strokes)
End Sub

private void mInkEdit_Recognition(object sender, InkEditRecognitionEventArgs e)
{
    RecognitionResult R = e.RecognitionResult;
    R.SetResultOnStrokes();
    // add these strokes to custom strokes collection
    // using R.Strokes[0].Id as the name
    R.Strokes.Ink.CustomStrokes.Add(R.Strokes[0].Id.ToString(), R.Strokes);
}

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.