Datenproxy mit Freihandanalyse

Wie in Ink Analysis Overviewerwähnt, verwaltet die Freihandanalysetechnologie intern ein strukturbasiertes Dokumentmodell, um Analyseergebnisse und Beziehungen zu enthalten. Wenn Ihre Anwendung bereits über einen etablierten Dokumentspeicher verfügt, der anders ist, müssen Sie die Freihandanalysefeatures verwenden, die für Proxydaten zwischen unterschiedlichen Dokumentmodellen entwickelt wurden.

Datentypen des Datenproxys

Die Datenproxyfeatures ermöglichen Ihrer Anwendung Folgendes:

• Integrieren Sie Analyseergebnisse zurück in ein vorhandenes Dokumentmodell.
• Kommunizieren Sie vorherige Ergebnisse (oder Zustand) zurück in die InkAnalyzer.
• Kommunizieren Sie den Nicht-Freihandzustand in den InkAnalyzer-.
• Kommunizieren Sie nur den minimalen Satz von Daten (sowohl vorheriger als auch nicht ink-Zustand), die zum Abschließen des Analysevorgangs erforderlich sind.
• Aktualisieren Sie einfach das interne Anwendungsdokumentmodell mit Analyseergebnissen.

Es gibt zwei grundlegende Ansätze für den Freihandanalysedatenproxy. Die Unterschiede liegen in den Details dazu, wann und wie die Synchronisierung zwischen den Dokumentmodellen auftritt. Der erste Ansatz, synchrone Aktualisierung, erfordert die Änderung des Freihandanalysedokumentmodells, da Änderungen im Anwendungsdokument auftreten. Der zweite Ansatz erfordert nur die Daten, die von Änderungen am Anwendungsdokumentmodell betroffen sind, an die InkAnalyzerübergeben werden. Das heißt, nur die Daten für die Teile des Freihandanalysedokumentmodells, die sich im selben Bereich wie Änderungen am Anwendungsdokument befinden, müssen an die InkAnalyzer übergeben werden, wie sie benötigt werden.

Synchrones Update

Der synchrone Aktualisierungsansatz erfordert die Änderung (Erstellung und Löschung) von Knoten im InkAnalyzer Objektauflistung von ContextNode Objekte, wie sie im Anwendungsdokument auftreten. Beispielsweise wird jedes Mal, wenn der Anwendung ein Textwort hinzugefügt wird, ein entsprechendes TextWord formatiert ContextNode im InkAnalyzererstellt. Wenn sich die Position des Textworts auf der Seite ändert, wird die Position der entsprechenden ContextNode- gleichzeitig aktualisiert. Diese Methode ist in Bezug auf Die Berechnung von Ressourcen weniger effizient als die On-Demand-Methode, da jede Dokumentänderung eine Aktualisierung der InkAnalyzerumfasst, auch wenn sich die Änderung nicht auf die zu analysierende Freihandeingabe auswirkt.

Das folgende Beispiel soll zeigen, wie synchrone Aktualisierung funktioniert. Stellen Sie sich eine Anwendung vor, die über ein vorhandenes Dokumentmodell verfügt. Wenn der Endbenutzer eine Änderung am Dokument vor nimmt, z. B. das Hinzufügen von neuem Text, wird die Änderung wie folgt verarbeitet:

1. Der Endbenutzer erstellt die neuen Daten.
2. Die Anwendung bestimmt, wie die Daten verarbeitet, gespeichert und gerendert werden.
3. Für praktische Zwecke werden die folgenden Schritte gleichzeitig durchgeführt.
   1. Die Anwendung platziert die Daten in das Dokumentmodell.
   2. Die Anwendung erstellt eine InkAnalyzer- und aktualisiert sie. Dadurch wird gleichzeitig sichergestellt, dass die InkAnalyzer immer über die neuesten Informationen verfügt.
   3. Die Anwendung ruft BackgroundAnalyze- für die InkAnalyzer- auf, um mit der Analyse zu beginnen.
4. Eine Reihe von Ereignissen wird ausgelöst, wenn die Änderung Freihand und die InkAnalyzer neue Ergebnisse bestimmt. Ein Ereignis wird für jede Änderung ausgelöst, die an der Auflistung von ContextNode-Objekten im InkAnalyzervorgenommen wurde. Zu diesen Ereignissen gehören ContextNodeCreated, ContextNodeDeleting, ContextNodeMovingToPosition, ContextNodePropertiesUpdated, ContextNodeLinkAdding, ContextNodeLinkDeletingund ContextNodeReparenting. Die Anwendung behandelt diese Ereignisse, um die Ergebnisse des Analysevorgangs nach Bedarf wieder in das Dokumentmodell zu proxyn.
5. Die Anwendung aktualisiert das Layout des Dokuments, wobei die neuen Daten aus dem Dokumentmodell abgerufen werden.
6. Die neuen Daten werden wieder an den Endbenutzer gerendert.

On-Demand-Update

Der On-Demand-Ansatz erfordert nur, dass die Daten für diejenigen ContextNode Objekte übergeben werden, die sich in den zu analysierenden Bereichen befinden. Die erforderlichen ContextNode--Objekte werden direkt nach dem Aufrufen des Analysevorgangs aus dem Dokumentmodell der Anwendung extrahiert, und erneut direkt vor der Abstimmung der Ergebnisse. Während die Implementierung komplizierter als synchrone Updates ist, führt dieser Ansatz zu besseren Leistungsergebnissen.

Verwandte Themen

Übersicht über die Freihandanalyse

InkAnalyzer-Klasse (C++)

Microsoft.Ink.InkAnalyzer

Microsoft.Ink.ContextNode