Метод IInkAnalyzer::GetDirtyRegion

Извлекает область, которая изменилась с момента последней операции анализа.

Синтаксис

HRESULT GetDirtyRegion(
  [out] IAnalysisRegion **ppDirtyRegion
);

Параметры

ppDirtyRegion [out]

IAnalysisRegion, описывающий область, которая изменилась с момента последней операции анализа.

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.

Remarks

Внимание!

Чтобы избежать утечки памяти, вызовите метод IUnknown::Release в ppDirtyRegion , если вам больше не нужно использовать объект .

Этот метод определяет области, которые необходимо проанализировать или повторно проанализировать. Все методы IInkAnalyzer, которые добавляют, обновляют или удаляют данные росчерка, обновляют грязное регионе. Чтобы вручную пометить область для повторного анализов, выполните приведенные ниже действия.

  1. Получите грязное регион с помощью метода IInkAnalyzer::GetDirtyRegion.
  2. Используйте метод IAnalysisRegion::UnionRegion или метод IAnalysisRegion::UnionRectangle , чтобы добавить область в регион из шага 1.
  3. Используйте метод IInkAnalyzer::SetDirtyRegion для обновления грязное региона.

IInkAnalyzer анализирует рукописный ввод в своей области грязное во время вызова метода IInkAnalyzer::Analyze или метода IInkAnalyzer::BackgroundAnalyze. Однако IInkAnalyzer может расширить операцию анализа, включив в нее соседние регионы.

Это свойство может содержать несмежные области.

Используйте CoTaskMemFree , чтобы освободить память из массива ppDirtyRegion после завершения работы с ним.

Требования

Требование Значение
Минимальная версия клиента
Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера
Ни одна версия не поддерживается
Заголовок
IACom.h (также требуется IACom_i.c)
DLL
IACom.dll

См. также раздел

IInkAnalyzer

Метод IInkAnalyzer::Analyze

Метод IInkAnalyzer::BackgroundAnalyze

Метод IInkAnalyzer::AddStroke

Метод IInkAnalyzer::AddStrokeForLanguage

Метод IInkAnalyzer::AddStrokes

Метод IInkAnalyzer::AddStrokesForLanguage

Метод IInkAnalyzer::RemoveStroke

Метод IInkAnalyzer::RemoveStrokes

Метод IInkAnalyzer::UpdateStrokesData

Справочник по анализу рукописного ввода