Metodo IInkAnalyzer::GetDirtyRegion

Recupera l'area modificata dall'ultima operazione di analisi.

Sintassi

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

Parametri

ppDirtyRegion [out]

IAnalysisRegion che descrive l'area modificata dall'ultima operazione di analisi.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Commenti

Attenzione

Per evitare una perdita di memoria, chiamare IUnknown::Release in ppDirtyRegion quando non è più necessario usare l'oggetto.

Questo metodo identifica le aree che devono essere analizzate o rianalisi. Tutti i metodi IInkAnalyzer che aggiungono, aggiornano o rimuovi i dati del tratto aggiornano l'area sporca. Per contrassegnare manualmente un'area per la rianalisi:

  1. Ottenere l'area sporca usando il metodo IInkAnalyzer::GetDirtyRegion.
  2. Usare il metodo IAnalysisRegion::UnionRegion o IAnalysisRegion::UnionRectangle Metodo per aggiungere l'area all'area dal passaggio 1.
  3. Usare il metodo IInkAnalyzer::SetDirtyRegion per aggiornare l'area sporca.

IInkAnalyzer analizza l'input penna all'interno della relativa area sporca durante una chiamata a IInkAnalyzer::Analizza metodo o IInkAnalyzer::BackgroundAnalyze. Tuttavia, IInkAnalyzer può espandere l'operazione di analisi per includere aree adiacenti.

Questa proprietà può contenere aree non adiacenti.

Usare CoTaskMemFree per liberare la memoria dalla matrice ppDirtyRegion al termine dell'operazione.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
Nessuno supportato
Intestazione
IACom.h (richiede anche IACom_i.c)
DLL
IACom.dll

Vedi anche

IInkAnalyzer

Metodo IInkAnalyzer::Analysis

Metodo IInkAnalyzer::BackgroundAnalyze

Metodo IInkAnalyzer::AddStroke

Metodo IInkAnalyzer::AddStrokeForLanguage

Metodo IInkAnalyzer::AddStrokes

Metodo IInkAnalyzer::AddStrokesForLanguage

Metodo IInkAnalyzer::RemoveStroke

Metodo IInkAnalyzer::RemoveStrokes

Metodo IInkAnalyzer::UpdateStrokesData

Informazioni di riferimento per l'analisi dell'input penna