InkAnalyzerBase.BackgroundAnalyze - метод

Статья
11/04/2008

Обновлен: Ноябрь 2007

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

Пространство имен: System.Windows.Ink.AnalysisCore
Сборка: IACore (в IACore.dll)

Синтаксис

'Декларация
Public Function BackgroundAnalyze As Boolean
'Применение
Dim instance As InkAnalyzerBase
Dim returnValue As Boolean

returnValue = instance.BackgroundAnalyze()

public bool BackgroundAnalyze()

public:
bool BackgroundAnalyze()

public boolean BackgroundAnalyze()

public function BackgroundAnalyze() : boolean

Возвращаемое значение

Тип: System.Boolean
true if the asynchronous ink analysis has started; otherwise, false.

Заметки

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

Примечание.
For the derived class, InkAnalyzer, the SynchronizingObject property controls upon which thread 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.

The InkAnalyzerBase analyzes ink within its DirtyRegion during a call to Analyze or BackgroundAnalyze. However, the ink analyzer may expand the analysis operation to include neighboring regions.

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 ReadyToReconcileBase event.
Your application has not added an event handler for the IntermediateResultsUpdatedBase or ResultsUpdatedBase event.
Your application has not added an event handler for the UpdateStrokesCacheBase event.

Примечание.

The derived class, InkAnalyzer, does not throw an exception under this condition.

Примечание.
The derived class, InkAnalyzer, does not throw an exception under this condition.

Примеры

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

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

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

Платформы

Windows Vista, Windows XP с пакетом обновления 2 (SP2), Windows Server 2003

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.