Метод IInkAnalyzer::Abort
Отменяет текущую операцию анализа.
Синтаксис
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
Параметры
-
ppAbortedRegion [out]
-
Указатель на IAnalysisRegion, представляющий грязное регион (см. раздел Метод IInkAnalyzer::GetDirtyRegion) текущей операции анализа.
Возвращаемое значение
Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.
Комментарии
Вызовите IUnknown::Release в ppAbortedRegion , если вам больше не нужно использовать объект .
Этот метод отменяет текущую операцию анализа.
Если ppAbortedRegion имеет значение NULL, этот метод выполняет прерывание в обычном режиме, так как это указывает на то, что вызывающий объект не заинтересован в возвращаемом значении.
Метод IInkAnalyzer::Abort заглушает события _IAnalysisEvents::Results и _IAnalysisEvents::Activity для текущей операции анализа.
Метод IInkAnalyzer::Abort выполняется асинхронно, пока текущая операция фонового анализа не будет отменена. Так как процесс отмены является асинхронным, приложение может выполнять другие задачи при отмене текущих операций анализа.
Если операции анализа не выполняются, этот метод возвращает пустую область анализа.
Если выполняется одна операция анализа, этот метод отменяет операцию.
Если выполняются синхронные и асинхронные операции анализа, этот метод отменяет синхронную операцию.
Если этот метод вызывается несколько раз для одной операции анализа, первый вызов возвращает грязное регион для операции, а последующие вызовы возвращают пустую область.
Если приложение поддерживает собственную структуру данных, синхронизированную с структурой IInkAnalyzer, вызов метода IInkAnalyzer::Abort может оставить документ с частичными результатами. Чтобы избежать этого, не вызывайте метод IInkAnalyzer::Abort между получением IInkAnalyzer события _IAnalysisProxyEvents::InkAnalyzerStateChanging и временем, когда IInkAnalyzer получает событие _IAnalysisEvents::IntermediateResults или _IAnalysisEvents::Results .
Дополнительные сведения об синхронизации данных приложения с анализатором рукописного ввода см. в разделе Data Proxy with Ink Analysis.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| DLL |
|