Método IInkAnalyzer::GetDirtyRegion
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:
- Obtenga la región desfasada mediante IInkAnalyzer::GetDirtyRegion (Método).
- Use IAnalysisRegion::UnionRegion (Método) o IAnalysisRegion::UnionRectangle (Método) para agregar el área a la región del paso 1.
- 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 |
|
| Archivo DLL |
|