Metodo InkAnalyzerBase.BackgroundAnalyze

Articolo
10/29/2008

Aggiornamento: novembre 2007

Esegue l'analisi asincrona dell'input penna che include l'analisi del layout, la classificazione della scrittura e del disegno e il riconoscimento della grafia.

Spazio dei nomi: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Sintassi

'Dichiarazione
Public Function BackgroundAnalyze As Boolean
'Utilizzo
Dim instance As InkAnalyzerBase
Dim returnValue As Boolean

returnValue = instance.BackgroundAnalyze()

public bool BackgroundAnalyze()

public:
bool BackgroundAnalyze()

public boolean BackgroundAnalyze()

public function BackgroundAnalyze() : boolean

Valore restituito

Tipo: System.Boolean
true se l'analisi asincrona dell'input penna è stata avviata; in caso contrario, false.

Note

Quando questo metodo viene chiamato, l'oggetto InkAnalyzerBase esegue l'analisi dell'input penna su un thread in background. L'oggetto InkAnalyzerBase genera eventi generati dall'analisi in background sul thread in cui è stata creata la proprietà InkAnalyzerBase.

Nota

Per la classe derivata, InkAnalyzer, la proprietà SynchronizingObject controlla il thread in cui InkAnalyzer genera gli eventi generati durante l'analisi in background.

Questo metodo non avvia una nuova operazione di analisi in background nelle circostanze indicate di seguito.

L'analizzatore dell'input penna sta attualmente eseguendo un'analisi in background.
L'oggetto DirtyRegion rappresenta un'area vuota.

L'oggetto InkAnalyzerBase analizza l'input penna nel relativo oggetto DirtyRegion durante una chiamata al metodo Analyze o BackgroundAnalyze. Tuttavia, l'analizzatore dell'input penna può espandere l'operazione di analisi in modo da includere le aree confinanti.

Questo metodo imposta la proprietà DirtyRegion su un'area vuota.

Se i dati del tratto sono stati aggiunti all'analizzatore dell'input penna dopo la chiamata al metodo BackgroundAnalyze, l'analizzatore dell'input penna può aggiornare la proprietà DirtyRegion durante la fase di riconciliazione dell'analisi dell'input penna.

Il valore della proprietà AnalysisModes specifica come l'analizzatore dell'input penna esegue l'analisi in background. Per ulteriori informazioni sull'analisi dell'input penna, vedere Ink Analysis Overview.

Questo metodo genera un'eccezione nelle circostanze indicate di seguito.

L'applicazione presenta il flag AutomaticReconciliationEnabled cancellato nella proprietà AnalysisModes e non ha aggiunto un gestore dell'evento ReadyToReconcileBase.
L'applicazione non ha aggiunto un gestore dell'evento IntermediateResultsUpdatedBase o ResultsUpdatedBase.
L'applicazione non ha aggiunto un gestore dell'evento UpdateStrokesCacheBase.

Nota

La classe derivata, InkAnalyzer, non genera un'eccezione in questa condizione.

Esempi

In questo esempio viene avviata l'analisi dell'input penna in background su un oggetto InkAnalyzerBase, theInkAnalyzerBase, se l'analizzatore dell'input penna non sta attualmente eseguendo l'analisi dell'input penna.

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

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

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.