Méthode IInkAnalyzer::GetDirtyRegion
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 :
- Obtenez la région sale à l’aide de la méthode IInkAnalyzer::GetDirtyRegion.
- Utilisez la méthode IAnalysisRegion::UnionRegion ou la méthode IAnalysisRegion::UnionRectangle pour ajouter la zone à la région de l’étape 1.
- 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 |
|
| DLL |
|