InkAnalyzer.BackgroundAnalyze Method

Article
12/12/2007

Performs asynchronous ink analysis, which includes layout analysis, writing and drawing classification, and handwriting recognition.

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

Not applicable.

Return Value

true if the asynchronous ink analysis has started; otherwise, false.

Remarks

When this method is called, the InkAnalyzer performs the ink analysis on a background thread. The InkAnalyzer raises events generated by the background analysis on the thread upon which the InkAnalyzer was created.

The SynchronizingObject property controls the thread upon which the InkAnalyzer raises events generated during background analysis.

This method does not start a new background analysis operation under the following circumstances.

The ink analyzer is currently performing background analysis.
DirtyRegion represents an empty area.

InkAnalyzer may expand the analysis operation to include neighboring regions even though it analyzes ink within its DirtyRegion during a call to Analyze or BackgroundAnalyze.

This method sets the DirtyRegion property to an empty region.

If stroke data was added to the ink analyzer after the call to BackgroundAnalyze, the ink analyzer may update the DirtyRegion property during the reconcile phase of ink analysis.

The value of the AnalysisModes property specifies how the ink analyzer performs background analysis. For more information about ink analysis, see Ink Analysis Overview.

This method throws an exception under the following circumstances.

Your application has the AutomaticReconciliationEnabled flag cleared in the AnalysisModes property and has not added an event handler for the ReadyToReconcile event.
Your application has not added an event handler for either the IntermediateResultsUpdated or the Results event.

Example

This example starts background ink analysis on an InkAnalyzer, theInkAnalyzer, if the ink analyzer is not currently performing ink analysis.

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

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

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0