Ink-Analyse mit dem Divider-Objekt

Das Divider-Objekt stellt Layoutanalysefeatures zur Verfügung, die Striche in verschiedene Strukturelemente klassifizieren und gruppieren.

Divider-Objekt

Das Divider-Objekt analysiert Striche, wenn Sie sie hinzufügen oder entfernen. Sie können die aktuelle Klassifizierung und Gruppierung der analysierten Striche in einem DivisionResult-Objekt abrufen, indem Sie die Divide-Methode des Divider-Objekts aufrufen.

Die vom Divider-Objekt analysierten Striche werden in der Strokes-Eigenschaft des Divider-Objekts beibehalten. Da eine Strokes-Auflistung ein Verweis auf Ink-Daten ist und nicht die tatsächlichen Daten selbst sind, können Änderungen im übergeordneten Ink-Objekt der Strokes-Auflistung die Strokes-Auflistung ungültig machen. Weitere Informationen zu Ink-Daten finden Sie unter Ink Data.

Das Divider-Objekt verwendet einen Erkennungskontext, um die Analyse von Erkennungssegmenten zu verbessern und Erkennungstext für Handschriftelemente zu generieren. Wenn der RecognizerContext-Eigenschaft des Divider-Objekts kein Erkennungskontext zugewiesen ist oder keine Erkennungen installiert sind, führt die Layoutanalysefunktion die Erkennungssegmentaufteilung aus, und dem DivisionResult-Objekt ist kein Text zugeordnet. Weitere Informationen zur Ink-Erkennung finden Sie unter Ink Recognition.

DivisionResult-Objekt

Jedes DivisionResult-Objekt zeichnet die Layoutanalyse der Striche auf, die zum Zeitpunkt des Aufrufens der Divide-Methode im Divider-Objekt enthalten sind. Das DivisionResult-Objekt speichert auch eine Kopie der Striche, die in der Analyse verwendet wurden.

Das DivisionResult-Objekt unterteilt die Analyseergebnisse nach strukturellem Elementtyp. Die ResultByType-Methode des DivisionResult-Objekts gibt in einer DivisionUnits-Auflistung die Auflistung aller strukturellen Elemente eines bestimmten Typs zurück. Die InkDivisionType-Enumeration definiert die Elementtypen, die von der Layoutanalyse erkannt werden.

In der folgenden Tabelle werden die Elementtypen in der InkDivisionType-Enumeration beschrieben.

Name BESCHREIBUNG
Segment
Ein Erkennungssegment.
Linie
Eine Handschriftzeile, die ein oder mehrere Erkennungssegmente enthält.
Paragraph
Ein Strichblock, der eine oder mehrere Handschriftzeilen enthält.
Zeichnung
Ink, die kein Text ist.

Die folgende Abbildung zeigt ein Beispiel für die verschiedenen Elementtypen, die das DivisionResult-Objekt erkennt.

Abbildung der verschiedenen Elementtypen, die das divisionresult-Objekt erkennt

DivisionUnits-Auflistung und DivisionUnit-Objekte

Jede DivisionUnits-Auflistung ist eine Kopie des Layoutanalyseergebnis für einen einzelnen Typ von strukturellen Element. Das DivisionUnit-Objekt stellt ein einzelnes Element in der DivisionUnits-Auflistung dar. Jedes strukturelle Element verfügt über einen Verweis auf die Striche, die das Element enthalten. Wenn Erkennungen installiert sind, steht Handschriftelementen Erkennungstext zur Verfügung. Linien- und Erkennungssegmentelemente enthalten auch eine Drehungsmatrix, die die Striche eines Elements von vertikal zu horizontal drehen kann.

Im Thema Ink Divider Sample wird veranschaulicht, wie ein Divider-Objekt mit Ink-Objekten verwendet wird, um eine Ink-Layoutanalyse durchzuführen.

Weitere Informationen zur Verwendung der Ink-Analyse finden Sie unter The Divider Object.