IInkAnalyzer :: GetDirtyRegion, méthode

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

Syntaxe

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

Paramètres

ppDirtyRegion [ à]

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

Valeur de retour

Pour obtenir une description des valeurs de retour, consultez classes et interfaces-analysede l’encre.

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 modifiée. Pour marquer manuellement une zone pour la réanalyse :

  1. Récupérez la région modifiée à l’aide de la méthode IInkAnalyzer :: GetDirtyRegion.
  2. Utilisez la méthode IAnalysisRegion :: UnionRegion ou IAnalysisRegion :: UnionRectangle pour ajouter la zone à la région à partir de l’étape 1.
  3. Utilisez la méthode IInkAnalyzer :: SetDirtyRegion pour mettre à jour la région modifiée.

Le IInkAnalyzer analyse l’encre au sein de sa région modifiée pendant un appel à la méthode IInkAnalyzer :: Analyze ou à la méthode IInkAnalyzer :: BackgroundAnalyze. Toutefois, le IInkAnalyzer peut développer 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 n’en avez plus besoin.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Applications de bureau XP Édition Tablet PC [ 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

Référence de l’analyse de l’encre