Méthode IInkAnalyzer::GetDirtyRegion

  • Article

Récupère la zone qui a changé depuis la dernière opération d’analyse.

Syntaxe

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

Paramètres

ppDirtyRegion [out]

IAnalysisRegion qui décrit la zone qui a changé depuis la dernière opération d’analyse.

Valeur retournée

Pour obtenir une description des valeurs renvoyées, consultez Classes et interfaces - Analyse de l’entrée manuscrite.

Notes

Attention

Pour éviter une fuite de mémoire, appelez IUnknown::Release sur ppDirtyRegion lorsque vous n’avez plus besoin d’utiliser l’objet .

Cette méthode identifie les zones qui doivent être analysées ou réanalysées. Toutes les méthodes IInkAnalyzer qui ajoutent, mettent à jour ou suppriment des données de trait mettent à jour la région sale. Pour marquer manuellement une zone pour une réanalyse :

  1. Obtenez la région sale à l’aide de la méthode IInkAnalyzer::GetDirtyRegion.
  2. Utilisez la méthode IAnalysisRegion::UnionRegion ou la méthode IAnalysisRegion::UnionRectangle pour ajouter la zone à la région de l’étape 1.
  3. Utilisez la méthode IInkAnalyzer::SetDirtyRegion pour mettre à jour la région sale.

IInkAnalyzer analyse l’entrée manuscrite dans sa région sale lors d’un appel à la méthode IInkAnalyzer::Analyze ou À la méthode IInkAnalyzer::BackgroundAnalyze. Toutefois, IInkAnalyzer peut étendre l’opération d’analyse pour inclure les régions voisines.

Cette propriété peut contenir des zones non adjacentes.

Utilisez CoTaskMemFree pour libérer la mémoire du tableau ppDirtyRegion lorsque vous en avez terminé.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge
 Aucun pris en charge
En-tête
IACom.h (nécessite également IACom_i.c)
DLL
IACom.dll

Voir aussi

IInkAnalyzer

IInkAnalyzer::Analyze, méthode

IInkAnalyzer::BackgroundAnalyze, méthode

IInkAnalyzer::AddStroke, méthode

IInkAnalyzer::AddStrokeForLanguage, méthode

IInkAnalyzer::AddStrokes, méthode

IInkAnalyzer::AddStrokesForLanguage, méthode

IInkAnalyzer::RemoveStroke, méthode

IInkAnalyzer::RemoveStrokes, méthode

IInkAnalyzer::UpdateStrokesData, méthode

Informations de référence sur l’analyse de l’encre