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 :
- Récupérez la région modifiée à l’aide de la méthode IInkAnalyzer :: GetDirtyRegion.
- Utilisez la méthode IAnalysisRegion :: UnionRegion ou IAnalysisRegion :: UnionRectangle pour ajouter la zone à la région à partir de l’étape 1.
- 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 |
|
| DLL |
|