InkAnalyzer.Abort-Methode

Artikel
11/26/2008

Bricht den aktuellen Analysevorgang ab.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Syntax

'Declaration
Public Function Abort As AnalysisRegion
'Usage
Dim instance As InkAnalyzer
Dim returnValue As AnalysisRegion

returnValue = instance.Abort()

public AnalysisRegion Abort()

public:
AnalysisRegion^ Abort()

public AnalysisRegion Abort()

public function Abort() : AnalysisRegion

Rückgabewert

Typ: Microsoft.Ink.AnalysisRegion
Der zu analysierende Bereich des aktuellen Analysevorgangs.

Hinweise

Nachdem diese Methode aufgerufen wurde, hört InkAnalyzer auf, Ereignisse für den abgebrochenen Analysevorgang auszulösen. Wenn ein Hintergrundanalysevorgang abgebrochen wird, wird diese Methode asynchron ausgeführt, bis InkAnalyzer den Vorgang beendet.

Wenn keine Analysevorgänge ausgeführt werden, gibt Abort einen leeren Analysebereich zurück.

Wenn ein Analysevorgang ausgeführt wird, bricht Abort den Vorgang ab.

Wenn sowohl synchrone als auch asynchrone Analysevorgänge ausgeführt werden, bricht Abort den synchronen Vorgang ab.

Wenn diese Methode mehr als einmal für denselben Analysevorgang aufgerufen wird, gibt der erste Aufruf den zu analysierenden Bereich für den Vorgang zurück, und nachfolgende Aufrufe geben einen leeren Bereich zurück.

Wenn Ihre Anwendung über eine eigene Datenstruktur verfügt, die mit der von InkAnalyzer synchronisiert wird, verfügt Ihr Dokument nach einem Aufruf von Abort möglicherweise nur über unvollständige Ergebnisse. Rufen Sie daher Abort nicht in der Zeit zwischen dem Aufruf des InkAnalyzerStateChanging-Ereignisses durch InkAnalyzer und dem Aufruf des IntermediateResultsUpdated-Ereignisses oder ResultsUpdated-Ereignisses durch InkAnalyzer auf.

Weitere Informationen über das Synchronisieren von Anwendungsdaten mit InkAnalyzer finden Sie unter Data Proxy with Ink Analysis.

Beispiele

In diesem Beispiel wird ein Ereignishandler für das InkAnalyzer.Activity-Ereignis definiert. Wenn ein Analysevorgang abgebrochen werden muss, ruft der Ereignishandler Abort für den InkAnalyzer auf, der das Ereignis generiert hat, und aktualisiert die DirtyRegion-Eigenschaft des InkAnalyzer-Objekts.

''' <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);
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.