InkAnalyzer.BackgroundAnalyze-Methode

Artikel
11/26/2008

Führt eine asynchrone Freihandanalyse durch. Diese umfasst die Layoutanalyse, die Schrift- und Zeichnungsklassifizierung und die Handschrifterkennung.

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

Syntax

'Declaration
Public Function BackgroundAnalyze As Boolean
'Usage
Dim instance As InkAnalyzer
Dim returnValue As Boolean

returnValue = instance.BackgroundAnalyze()

public bool BackgroundAnalyze()

public:
bool BackgroundAnalyze()

public boolean BackgroundAnalyze()

public function BackgroundAnalyze() : boolean

Rückgabewert

Typ: System.Boolean
true , wenn die asynchrone Freihandanalyse gestartet wurde, andernfalls false.

Hinweise

Wenn diese Methode aufgerufen wird, führt InkAnalyzer die Freihandanalyse für einen Hintergrundthread aus. InkAnalyzer löst Ereignisse aus, die durch die Hintergrundanalyse des Threads generiert wurden, für den InkAnalyzer erstellt wurde.

Mit der SynchronizingObject-Eigenschaft wird gesteuert, für welchen Thread InkAnalyzer Ereignisse auslöst, die während der Hintergrundanalyse generiert werden.

Diese Methode startet unter den folgenden Bedingungen keine neue Hintergrundanalyse.

Das Freihandanalysemodul führt gegenwärtig eine Hintergrundanalyse durch.
DirtyRegion stellt einen leeren Bereich dar.

InkAnalyzer analysiert Freihand in seiner DirtyRegion während eines Aufrufs von Analyze oder BackgroundAnalyze. Das Freihandanalysemodul kann jedoch den Analysevorgang auf angrenzende Bereiche ausweiten.

Diese Methode legt die DirtyRegion-Eigenschaft auf einen leeren Bereich fest.

Wenn nach dem Aufruf von BackgroundAnalyze Strichdaten zum Freihandanalysemodul hinzugefügt wurden, kann das Freihandanalysemodul die DirtyRegion-Eigenschaft während der Abgleichsphase der Freihandanalyse aktualisieren.

Der Wert der AnalysisModes-Eigenschaft gibt an, wie das Freihandanalysemodul die Hintergrundanalyse ausführt. Weitere Informationen zur Freihandanalyse finden Sie unter Ink Analysis Overview.

Diese Methode löst unter den folgenden Bedingungen eine Ausnahme aus.

Bei Ihrer Anwendung ist das AutomaticReconciliationEnabled-Flag der AnalysisModes-Eigenschaft gelöscht und wurde kein Ereignishandler für das ReadyToReconcile-Ereignis hinzugefügt.
Ihre Anwendung hat keinen Ereignishandler für das IntermediateResultsUpdated-Ereignis oder ResultsUpdated-Ereignis hinzugefügt.

Beispiele

Dieses Beispiel startet die Freihandanalyse von InkAnalyzer (theInkAnalyzer) im Hintergrund, wenn das Freihandanalysemodul nicht gerade eine Freihandanalyse durchführt.

If Not theInkAnalyzer.IsAnalyzing Then
    Dim started As Boolean = theInkAnalyzer.BackgroundAnalyze()
End If

if (!theInkAnalyzer.IsAnalyzing)
{
    bool started = theInkAnalyzer.BackgroundAnalyze();
}

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.