RecognitionResult.SetResultOnStrokes-Methode

Artikel
10/28/2008

Weist das RecognitionResult-Objekt der Strokes-Auflistung zu, die zum Generieren der Ergebnisse verwendet wurde.

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

Syntax

'Declaration
Public Sub SetResultOnStrokes
'Usage
Dim instance As RecognitionResult

instance.SetResultOnStrokes()

public void SetResultOnStrokes()

public:
void SetResultOnStrokes()

public void SetResultOnStrokes()

public function SetResultOnStrokes()

Hinweise

Die Systemleistung wird beeinträchtigt, wenn jeder Strokes-Auflistung automatisch Erkennungsergebnisse zugewiesen werden. Deshalb werden Ergebnisse nicht standardmäßig an eine Strokes-Auflistung angefügt. Sie müssen die SetResultOnStrokes-Methode aufrufen, um einer Strokes-Auflistung Ergebnisse zuzuweisen. Verwenden Sie für die Rückgabe der Erkennungsergebnisse einer Strokes-Auflistung die RecognitionResult-Eigenschaft der Strokes-Auflistung. Nachdem Sie einer Strokes-Auflistung Ergebnisse zugewiesen haben, können Sie die Striche in einer CustomStrokes-Auflistung speichern. Diese benutzerdefinierten Striche sowie das RecognitionResult können beibehalten und zur späteren Verwendung abgerufen werden.

Beispiele

In diesem Beispiel wird die synchrone Erkennung als Reaktion auf eine Benutzeraktion wie das Klicken auf ein Menüelement oder auf eine Schaltfläche behandelt. Zunächst wird die Strokes-Auflistung eines RecognizerContext-Objekts von der Strokes-Auflistung zugewiesen, die einem InkOverlay-Objekt zugeordnet ist, und auf die Anzahl der Striche überprüft. Wenn die Strokes-Auflistung mindestens ein Stroke-Objekt enthält, beginnt der Erkennungsprozess mit einem Aufruf der Recognize-Methode. Wenn die Erkennung erfolgreich ist, wird die SetResultOnStrokes-Methode aufgerufen, um das RecognizerContext-Objekt an seine entsprechende Strokes-Auflistung anzuhängen. Schließlich wird die Strokes-Auflistung als benannte CustomStrokes-Auflistung gespeichert. Dadurch wird das angefügte RecognitionResult ebenfalls gespeichert.

' assign strokes collection from the collected strokes
Me.mRecognizerContext.Strokes = Me.mInkOverlay.Ink.Strokes
' check stroke count. Recognize() will throw exception if no strokes
If Me.mRecognizerContext.Strokes.Count > 0 Then
    Dim status As RecognitionStatus
    ' perform the recognition
    Dim rResult As RecognitionResult = Me.mRecognizerContext.Recognize(status)
    ' check status
    If RecognitionStatus.NoError = status Then
        ' attach RecognitionResult to the Strokes collection
        rResult.SetResultOnStrokes()
        ' save the strokes collection (with RecognitionResult attached)
        Try
            mInkOverlay.Ink.CustomStrokes.Add("customCollectionName", rResult.Strokes)
        Catch ex As ArgumentException
            ' this exception is raised when the named collection already exists
        End Try
    End If
End If

// assign strokes collection from the collected strokes
this.mRecognizerContext.Strokes = this.mInkOverlay.Ink.Strokes;
// check stroke count. Recognize() will throw exception if no strokes
if (this.mRecognizerContext.Strokes.Count > 0)
{
    RecognitionStatus status;
    // perform the recognition
    RecognitionResult rResult = this.mRecognizerContext.Recognize(out status);
    // check status
    if (RecognitionStatus.NoError == status)
    {
        // attach RecognitionResult to the Strokes collection
        rResult.SetResultOnStrokes();
        // save the strokes collection (with RecognitionResult attached)
        try
        {
            mInkOverlay.Ink.CustomStrokes.Add("customCollectionName", rResult.Strokes);
        }
        catch (ArgumentException)
        {
            // this exception is raised when the named collection already exists
        }
    }
}

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.