Metodo InkAnalyzer.Abort

Articolo
10/29/2008

Aggiornamento: novembre 2007

Annulla l'operazione di analisi corrente.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Function Abort As AnalysisRegion
'Utilizzo
Dim instance As InkAnalyzer
Dim returnValue As AnalysisRegion

returnValue = instance.Abort()

public AnalysisRegion Abort()

public:
AnalysisRegion^ Abort()

public AnalysisRegion Abort()

public function Abort() : AnalysisRegion

Valore restituito

Tipo: Microsoft.Ink.AnalysisRegion
Area modificata dell'operazione di analisi corrente.

Note

Dopo avere chiamato questo metodo, l'oggetto InkAnalyzer termina la generazione di eventi per l'operazione di analisi annullata. Se viene annullata un'operazione di analisi in background, questo metodo viene eseguito in modo asincrono finché l'oggetto InkAnalyzer non interrompe l'operazione.

Se non è in esecuzione alcuna operazione di analisi, il metodo Abort restituisce un'area di analisi vuota.

Se è in esecuzione un'operazione di analisi, il metodo Abort annulla l'operazione.

Se sono in esecuzione operazioni di analisi sincrone e asincrone, il metodo Abort annulla l'operazione sincrona.

Se questo metodo viene chiamato più volte per la stessa operazione di analisi, la prima chiamata restituisce l'area modificata per l'operazione e le chiamate successive restituiscono un'area vuota.

Se l'applicazione gestisce una struttura di dati personalizzata, sincronizzata con quella dell'oggetto InkAnalyzer, la chiamata del metodo Abort può generare documenti con risultati parziali. Per evitare questa situazione, non chiamare il metodo Abort tra il momento in cui l'oggetto InkAnalyzer genera l'evento InkAnalyzerStateChanging e l'oggetto InkAnalyzer genera l'evento IntermediateResultsUpdated o ResultsUpdated.

Per ulteriori informazioni sulla sincronizzazione dei dati applicazioni con InkAnalyzer, vedere Data Proxy with Ink Analysis.

Esempi

In questo esempio viene definito un gestore eventi per l'evento InkAnalyzer.Activity. Se l'operazione di analisi deve essere annullata, il gestore eventi chiama il metodo Abort sull'oggetto InkAnalyzer che ha generato l'evento e aggiorna la proprietà DirtyRegion dell'oggetto InkAnalyzer.

''' <summary>
''' The ink analyzer's Activity event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInkAnalyzer_Activity(ByVal sender As Object, ByVal e As EventArgs)
    Dim abortAnalysis As Boolean = False

    ' Check if the analysis operation should be canceled.
    ' Abort analysis if the flag to do so is set.
    If abortAnalysis Then
        ' Get the InkAnalyzer that raised the Activity event.
        Dim theInkAnalyzer As Microsoft.Ink.InkAnalyzer = _
            DirectCast(sender, Microsoft.Ink.InkAnalyzer)

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegion As Microsoft.Ink.AnalysisRegion = _
            theInkAnalyzer.Abort()

        ' Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion)
    End If

End Sub 'theInkAnalyzer_Activity

/// <summary>
/// The ink analyzer's Activity event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkAnalyzer_Activity(object sender, EventArgs e)
{
    bool abortAnalysis = false;

    // Check if the analysis operation should be canceled.

    // Abort analysis if the flag to do so is set.
    if (abortAnalysis)
    {
        // Get the InkAnalyzer that raised the Activity event.
        Microsoft.Ink.InkAnalyzer theInkAnalyzer =
            sender as Microsoft.Ink.InkAnalyzer;

        // Abort the analysis and get the region that was being analyzed.
        Microsoft.Ink.AnalysisRegion theAnalysisRegion = theInkAnalyzer.Abort();

        // Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion);
    }
}

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.