Freigeben über


CustomRecognizerNode-Klasse

Stellt einen ContextNode für einen einzelnen Erkennungsvorgang dar. Alle Striche und Knoten, die unter einem CustomRecognizerNode-Knoten gespeichert sind, werden in einem unabhängigen Erkennungsvorgang erkannt und werden nicht von InkAnalyzer analysiert.

Namespace:  System.Windows.Ink
Assembly:  IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public NotInheritable Class CustomRecognizerNode _
    Inherits ContextNode
'Usage
Dim instance As CustomRecognizerNode
public sealed class CustomRecognizerNode : ContextNode
public ref class CustomRecognizerNode sealed : public ContextNode
public final class CustomRecognizerNode extends ContextNode
public final class CustomRecognizerNode extends ContextNode

Hinweise

Ein CustomRecognizerNode-Objekt kann beliebige ContextNode-Typen annehmen, mit der Ausnahme des RootNode-Typs. Ein CustomRecognizerNode-Objekt muss dem RootNode-Knoten direkt untergeordnet sein.

Die einfachste Möglichkeit, ein benutzerdefiniertes Erkennungsmodul zu erstellen, besteht darin, InkAnalyzer.CreateCustomRecognizer zu verwenden, um das Modul zu erstellen, und ihm anschließend mithilfe von InkAnalyzerAddStrokesToCustomRecognizer(StrokeCollection, ContextNode) Striche zuzuweisen. Wenn ein Strich, den Sie dem Erkennungsmodul zuweisen möchten, bereits einem Knoten, einschließlich eines UnclassifiedInkNode, in der InkAnalyzer-Kontextstruktur zugewiesen ist, wird eine ArgumentException ausgelöst. Um dies zu vermeiden, verwenden Sie InkAnalyzer.RemoveStroke oder InkAnalyzer.RemoveStrokes, um diese Striche aus der InkAnalyzer-Kontextstruktur zu entfernen, bevor Sie sie im benutzerdefinierten Erkennungsmodul hinzufügen.

Beispiele

Im folgenden Beispiel wird eine Guid für ein benutzerdefiniertes Erkennungsmodul mit dem Namen customRecognizerId angenommen und damit ein CustomRecognizerNode für einen InkAnalyzer mit dem Namen theInkAnalyzer erstellt. Anschließend werden Striche aus einer StrokeCollection namens strokesForCustomAnalysis hinzugefügt. Dann wird Analyze aufgerufen, und die erkannte Zeichenfolge wird in einer TextBox namens theResultsTextBox abgelegt.

Dim customRecognizer As CustomRecognizerNode = _
    theInkAnalyzer.CreateCustomRecognizer(customRecognizerId)
theInkAnalyzer.AddStrokesToCustomRecognizer(strokesForCustomAnalysis, customRecognizer)

Dim theStatus As AnalysisStatus = theInkAnalyzer.Analyze()
theResultsTextBox.Text = customRecognizer.GetRecognizedString()
CustomRecognizerNode customRecognizer =
    theInkAnalyzer.CreateCustomRecognizer(customRecognizerId);
theInkAnalyzer.AddStrokesToCustomRecognizer(strokesForCustomAnalysis, customRecognizer);

AnalysisStatus theStatus = theInkAnalyzer.Analyze();
theResultsTextBox.Text = customRecognizer.GetRecognizedString();

Vererbungshierarchie

System.Object
  System.Windows.Ink.ContextNode
    System.Windows.Ink.CustomRecognizerNode

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

CustomRecognizerNode-Member

System.Windows.Ink-Namespace