InkAnalyzer.BackgroundAnalyze-Methode
Führt eine asynchrone Freihandanalyse durch; diese umfasst die Layoutanalyse, die Schrift- und Zeichnungsklassifizierung und die Handschrifterkennung.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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 in einem Hintergrundthread aus. Der InkAnalyzer löst Ereignisse aus, die durch die Freihandanalyse in demselben Thread generiert wurden, für den SynchronizingObject erstellt wurde. Wenn die InkAnalyzer.SynchronizingObject-Eigenschaft nullNULL-Verweis (Nothing in Visual Basic) ist, löst der InkAnalyzer auch diese Ereignisse in einem Hintergrundthread aus.
Mit der SynchronizingObject-Eigenschaft wird gesteuert, in welchem 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 kann den Analysevorgang auf angrenzende Bereiche ausweiten, auch wenn es während eines Aufrufs von Analyze oder BackgroundAnalyze eine Freihandanalyse in seiner DirtyRegion ausführt.
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 [F:System.Windows.Ink. AnalysisModes.AutomaticReconciliationEnabled]-Flag der AnalysisModes-Eigenschaft deaktiviert, und es wurde kein Ereignishandler für das ReadyToReconcile-Ereignis hinzugefügt.
Ihre Anwendung hat keinen Ereignishandler für das IntermediateResultsUpdated-Ereignis oder das Results()-Ereignis hinzugefügt.
Beispiele
In diesem Beispiel wird die Freihandanalyse durch einen InkAnalyzer namens theInkAnalyzer im Hintergrund gestartet, wenn das Freihandanalysemodul nicht gerade eine Analyse 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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0
Siehe auch
Referenz
InkAnalyzerBaseAnalysisModes()
InkAnalyzerBaseDirtyRegion()
InkAnalyzerBaseRootNode()
InkAnalyzerBaseAnalyze()