IInkAnalyzer::Abort-Methode

Bricht den aktuellen Analysevorgang ab.

Syntax

HRESULT Abort(
  [out] IAnalysisRegion **ppAbortedRegion
);

Parameter

ppAbortedRegion [ out]

Ein Zeiger auf eine IAnalysisRegion, die den geänderten Bereich (siehe IInkAnalyzer::GetDirtyRegion-Methode)des aktuellen Analysevorgangs darstellt.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Ink-Analyse.

Hinweise

Rufen Sie IUnknown::Release für ppAbortedRegion auf, wenn Sie das Objekt nicht mehr verwenden müssen.

Diese Methode bricht den aktuellen Analysevorgang ab.

Wenn ppAbortedRegion NULL ist, führt diese Methode den Abbruch wie gewohnt aus, da dies angibt, dass der Aufrufer kein Interesse am Rückgabewert hat.

Die IInkAnalyzer::Abort-Methode stillt die _ Ereignisse IAnalysisEvents::Results und _ IAnalysisEvents::Activity für den aktuellen Analysevorgang.

Die IInkAnalyzer::Abort-Methode wird asynchron ausgeführt, bis der aktuelle Hintergrundanalysevorgang abgebrochen wird. Da der Abbruchvorgang asynchron ist, kann die Anwendung andere Aufgaben ausführen, während die aktuellen Analysevorgänge abgebrochen werden.

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

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

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

Wenn diese Methode für denselben Analysevorgang mehr als einmal aufgerufen wird, gibt der erste Aufruf den geänderten Bereich für den Vorgang zurück, und die nachfolgenden Aufrufe geben einen leeren Bereich zurück.

Wenn Ihre Anwendung eine eigene Datenstruktur beibehält, die mit der der IInkAnalyzersynchronisiert wird, kann der Aufruf der IInkAnalyzer::Abort-Methode ihr Dokument mit Teilergebnissen belassen. Um dies zu vermeiden, rufen Sie die IInkAnalyzer::Abort-Methode nicht zwischen dem Empfang des _ IAnalysisProxyEvents::InkAnalyzerStateChanging-Ereignisses und dem Zeitpunkt auf, zu dem IInkAnalyzer das _ IAnalysisEvents::IntermediateResults- oder _ IAnalysisEvents::Results-Ereignis empfängt.

Weitere Informationen zum Synchronisieren Ihrer Anwendungsdaten mit dem Ink-Analysetools finden Sie unter Datenproxy mit Ink-Analyse.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
IACom.h (erfordert auch IACom _ i.c)
DLL
IACom.dll

Weitere Informationen

IInkAnalyzer

IInkAnalyzer::Analyze-Methode

IInkAnalyzer::BackgroundAnalyze-Methode

IInkAnalyzer::GetDirtyRegion-Methode

IInkAnalyzer::SetDirtyRegion-Methode

Referenz zur Ink-Analyse