Método IInkAnalyzer::GetDirtyRegion

  • Artigo

Recupera a área que foi alterada desde a última operação de análise.

Sintaxe

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

Parâmetros

ppDirtyRegion [out]

Uma IAnalysisRegion que descreve a área que foi alterada desde a última operação de análise.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e Interfaces – Análise de Tinta.

Comentários

Cuidado

Para evitar um vazamento de memória, chame IUnknown::Release em ppDirtyRegion quando você não precisar mais usar o objeto.

Esse método identifica as áreas que precisam ser analisadas ou reanalisadas. Todos os métodos IInkAnalyzer que adicionam, atualizam ou removem dados de traço atualizam a região sujo. Para marcar manualmente uma área para reanálise:

  1. Obtenha a região sujo usando o Método IInkAnalyzer::GetDirtyRegion.
  2. Use o Método IAnalysisRegion::UnionRegion ou o Método IAnalysisRegion::UnionRectangle para adicionar a área à região a partir da etapa 1.
  3. Use o Método IInkAnalyzer::SetDirtyRegion para atualizar a região sujo.

O IInkAnalyzer analisa a tinta em sua região de sujo durante uma chamada ao Método IInkAnalyzer::Analyze ou ao Método IInkAnalyzer::BackgroundAnalyze. No entanto, o IInkAnalyzer pode expandir a operação de análise para incluir regiões vizinhas.

Essa propriedade pode conter áreas não locais.

Use CoTaskMemFree para liberar a memória da matriz ppDirtyRegion quando terminar de usá-la.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Nenhum compatível
Cabeçalho
IACom.h (também requer IACom_i.c)
DLL
IACom.dll

Confira também

IInkAnalyzer

Método 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

Referência de análise de tinta