Método IInkAnalyzer::GetDirtyRegion
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:
- Obtenha a região sujo usando o Método IInkAnalyzer::GetDirtyRegion.
- Use o Método IAnalysisRegion::UnionRegion ou o Método IAnalysisRegion::UnionRectangle para adicionar a área à região a partir da etapa 1.
- 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 |
|
| DLL |
|