IInkAnalyzer::Abort-Methode
Bricht den aktuellen Analysevorgang ab.
Syntax
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
Parameter
-
ppAbortedRegion [out]
-
Ein Zeiger auf eine IAnalysisRegion, die die modifiziert Region darstellt (siehe IInkAnalyzer::GetDirtyRegion-Methode) des aktuellen Analysevorgangs.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.
Bemerkungen
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 ppAbortedRegionNULL ist, führt diese Methode den Abbruch normal aus, da dies angibt, dass der Aufrufer kein Interesse an dem Rückgabewert hat.
IInkAnalyzer::Abort-Methode beendet die _IAnalysisEvents::Results - und _IAnalysisEvents::Activity-Ereignisse für den aktuellen Analysevorgang.
IInkAnalyzer::Abort-Methode wird asynchron ausgeführt, bis der aktuelle Hintergrundanalysevorgang abgebrochen wird. Da der Abbruchprozess 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, wird der Vorgang von dieser Methode abgebrochen.
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 mehrmals aufgerufen wird, gibt der erste Aufruf die modifiziert Region für den Vorgang zurück, und die nachfolgenden Aufrufe geben einen leeren Bereich zurück.
Wenn Ihre Anwendung eine eigene Datenstruktur verwaltet, die mit der des IInkAnalyzer synchronisiert ist, kann das Aufrufen 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 Empfang des_IAnalysisEvents::IntermediateResults- oder _IAnalysisEvents::Results-Ereignisses auf.
Weitere Informationen zum Synchronisieren Ihrer Anwendungsdaten mit der Freihandanalyse finden Sie unter Datenproxy mit Freihandanalyse.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|