Metodo InkAnalyzer.BackgroundAnalyze
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: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Sintassi
'Dichiarazione
Public Function BackgroundAnalyze As Boolean
'Utilizzo
Dim instance As InkAnalyzer
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 InkAnalyzer esegue l'analisi dell'input penna su un thread in background. L'oggetto InkAnalyzer genera eventi generati dall'analisi in background sul thread in cui è stata creata la proprietà InkAnalyzer.
La proprietà SynchronizingObject controlla in quale thread l'oggetto InkAnalyzer genera gli eventi che vengono 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 InkAnalyzer 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 risoluzione delle differenze 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 ha il flag AutomaticReconciliationEnabled cancellato nella proprietà AnalysisModes e non ha aggiunto un gestore eventi per l'evento ReadyToReconcile.
L'applicazione non ha aggiunto un gestore eventi per l'evento IntermediateResultsUpdated o ResultsUpdated.
Esempi
In questo esempio viene avviata l'analisi dell'input penna in background su un oggetto InkAnalyzer, theInkAnalyzer, se l'analizzatore dell'input penna non sta attualmente eseguendo l'analisi dell'input penna.
If Not theInkAnalyzer.IsAnalyzing Then
Dim started As Boolean = theInkAnalyzer.BackgroundAnalyze()
End If
if (!theInkAnalyzer.IsAnalyzing)
{
bool started = theInkAnalyzer.BackgroundAnalyze();
}
Piattaforme
Windows Vista
.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.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0