Metodo InkAnalyzer.Abort

Articolo
10/29/2008

Aggiornamento: novembre 2007

Annulla l'operazione di analisi corrente.

Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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: System.Windows.Ink.AnalysisRegion
Area modificata dell'operazione di analisi corrente.

Note

Quando viene chiamato questo metodo, InkAnalyzer arresta la generazione degli eventi per l'operazione di analisi annullata. Se si annulla un'operazione di analisi in background, questo metodo viene eseguito in modo asincrono finché InkAnalyzer non interrompe l'operazione. È necessario tenere in considerazione le seguenti condizioni:

Se non è in esecuzione alcuna operazione di analisi, Abort restituisce un'area di analisi vuota.
Se è in esecuzione un'operazione di analisi, Abort annulla l'operazione.
Se sono in esecuzione operazioni di analisi sincrone e asincrone, 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, Abort può produrre documenti che contengono solo risultati parziali. Per evitare i risultati parziali, non chiamare Abort nel periodo che intercorre da quando InkAnalyzer genera l'evento InkAnalyzerStateChanging a quando InkAnalyzer genera l'evento IntermediateResults() o l'evento Results().

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

Esempi

In questo esempio viene definito un gestore 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 conseguentemente aggiorna l'oggetto DirtyRegion di 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 InkAnalyzer = sender

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegion As 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.
        InkAnalyzer theInkAnalyzer =
            sender as InkAnalyzer;

        // Abort the analysis and get the region that was being analyzed.
        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.