Metodo InkAnalyzerBase.Abort

Articolo
10/29/2008

Aggiornamento: novembre 2007

Annulla l'operazione di analisi corrente.

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

Sintassi

'Dichiarazione
Public Function Abort As AnalysisRegionBase
'Utilizzo
Dim instance As InkAnalyzerBase
Dim returnValue As AnalysisRegionBase

returnValue = instance.Abort()

public AnalysisRegionBase Abort()

public:
AnalysisRegionBase^ Abort()

public AnalysisRegionBase Abort()

public function Abort() : AnalysisRegionBase

Valore restituito

Tipo: System.Windows.Ink.AnalysisCore.AnalysisRegionBase
Area modificata dell'operazione di analisi corrente.

Note

Dopo avere chiamato questo metodo, l'oggetto InkAnalyzerBase 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'analizzatore dell'input penna non interrompe l'operazione.

Se non è in esecuzione alcuna operazioni di analisi, questo metodo restituisce un'area di analisi vuota.

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

Se sono in esecuzione operazioni di analisi sincrone e asincrone, questo metodo 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 InkAnalyzerBase, 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 InkAnalyzerBase genera l'evento InkAnalyzerStateChangingBase e il momento in cui l'oggetto InkAnalyzerBase genera l'evento IntermediateResultsUpdatedBase o ResultsUpdatedBase.

Per ulteriori informazioni sulla sincronizzazione dei dati delle applicazioni con l'analizzatore dell'input penna, vedere Data Proxy with Ink Analysis.

Esempi

In questo esempio viene definito un gestore dell'evento ActivityBase dell'analizzatore dell'input penna. Se l'operazione di analisi deve essere annullata, il gestore dell'evento chiama il metodo Abort sull'oggetto InkAnalyzerBase che ha generato l'evento e aggiorna la proprietà DirtyRegion dell'analizzatore.

''' <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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        Dim theInkAnalyzerBase As System.Windows.Ink.AnalysisCore.InkAnalyzerBase = _
            DirectCast(sender, System.Windows.Ink.AnalysisCore.InkAnalyzerBase)

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegionBase As System.Windows.Ink.AnalysisCore.AnalysisRegionBase = _
            theInkAnalyzerBase.Abort()

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

End Sub 'theInkAnalyzerBase_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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        System.Windows.Ink.AnalysisCore.InkAnalyzerBase theInkAnalyzerBase =
            sender as System.Windows.Ink.AnalysisCore.InkAnalyzerBase;

        // Abort the analysis and get the region that was being analyzed.
        System.Windows.Ink.AnalysisCore.AnalysisRegionBase theAnalysisRegionBase =
            theInkAnalyzerBase.Abort();

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

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.