Método IInkAnalyzer::GetDirtyRegion

  • Artículo

Recupera el área que ha cambiado desde la última operación de análisis.

Sintaxis

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

Parámetros

ppDirtyRegion [out]

Un IAnalysisRegion que describe el área que ha cambiado desde la última operación de análisis.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.

Observaciones

Precaución

Para evitar una pérdida de memoria, llame a IUnknown::Release en ppDirtyRegion cuando ya no necesite usar el objeto .

Este método identifica las áreas que se deben analizar o volver a analizar. Todos los métodos de IInkAnalyzer que agregan, actualizan o quitan datos de trazo actualizan la región desfasada. Para marcar manualmente un área para volver a analizar:

  1. Obtenga la región desfasada mediante IInkAnalyzer::GetDirtyRegion (Método).
  2. Use IAnalysisRegion::UnionRegion (Método) o IAnalysisRegion::UnionRectangle (Método) para agregar el área a la región del paso 1.
  3. Use IInkAnalyzer::SetDirtyRegion (Método) para actualizar la región desfasada.

El IInkAnalyzer analiza la entrada de lápiz dentro de su región sucia durante una llamada a IInkAnalyzer::Analyze (Método) o IInkAnalyzer::BackgroundAnalyze (Método). Sin embargo, IInkAnalyzer puede expandir la operación de análisis para incluir regiones vecinas.

Esta propiedad puede contener áreas no adyacentes.

Use CoTaskMemFree para liberar la memoria de la matriz ppDirtyRegion cuando haya terminado con ella.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Encabezado
IACom.h (también requiere IACom_i.c)
Archivo DLL
IACom.dll

Consulte también

IInkAnalyzer

IInkAnalyzer::Analyze (Método)

IInkAnalyzer::BackgroundAnalyze (Método)

IInkAnalyzer::AddStroke (Método)

IInkAnalyzer::AddStrokeForLanguage (Método)

IInkAnalyzer::AddStrokes (Método)

IInkAnalyzer::AddStrokesForLanguage (Método)

IInkAnalyzer::RemoveStroke (Método)

IInkAnalyzer::RemoveStrokes (Método)

IInkAnalyzer::UpdateStrokesData (Método)

Referencia de análisis de entrada de lápiz