InkAnalyzer.Abort-Methode

Artikel
10/28/2008

Bricht den aktuellen Analysevorgang ab.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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: System.Windows.Ink.AnalysisRegion
Der zu analysierende Bereich des aktuellen Analysevorgangs.

Hinweise

Sobald diese Methode aufgerufen wird, löst der InkAnalyzer keine Ereignisse mehr für den abgebrochenen Analysevorgang aus. Wenn ein Hintergrundanalysevorgang abgebrochen wird, wird diese Methode asynchron ausgeführt, bis InkAnalyzer den Vorgang beendet. Berücksichtigen Sie die folgenden Bedingungen:

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 mit derjenigen des InkAnalyzer über eine eigene, synchronisierte Datenstruktur verfügt, kann der Aufruf von Abort Dokumente erzeugen, die nur teilweise Ergebnisse enthalten. Um partielle Ergebnisse zu vermeiden, rufen Sie Abort ab dem Zeitpunkt, zu dem InkAnalyzer das InkAnalyzerStateChanging-Ereignis auslöst, bis zu dem Zeitpunkt, zu dem InkAnalyzer entweder das IntermediateResults()-Ereignis oder das Results()-Ereignis auslöst, nicht auf.

Weitere Informationen zum 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 die Abort-Methode des InkAnalyzer auf, der das Ereignis generiert hat, und aktualisiert auf diese Weise die DirtyRegion 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 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);
    }
}

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.