Méthode IAnalysisRegion::GetRegionScans
Récupère un tableau de rectangles qui définit la zone de IAnalysisRegion.
Syntaxe
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
Paramètres
-
pulCount [out]
-
Nombre de rectangles retournés dans pRegionScans.
-
pRegionScans [out]
-
Pointeur vers un tableau de rectangles qui définit la zone de IAnalysisRegion.
Valeur retournée
Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse manuscrite.
Notes
Si pRegionScans est passé en tant que NULL, la méthode GetRegionScans retourne S_OK et le nombre de rectangles est retourné dans pulCount.
Attention
Pour éviter une fuite de mémoire, utilisez CoTaskMemFree pour libérer la mémoire de *pRegionScans lorsque vous n’avez plus besoin des informations.
Les limites des rectangles sont en coordonnées d’espace d’entrée manuscrite.
L’union des rectangles retournés représente la zone de la IAnalysisRegion.
Exemples
L’exemple suivant montre comment obtenir les rectangles qui définissent la zone de IAnalysisRegion et region comment obtenir uniquement le nombre de rectangles.
// Get the count and the rectangles.
ULONG count = 0;
RECT* rects = 0;
region->GetRegionScans(&count, &rects);
// Use rects
::CoTaskMemFree(rects);
// GetRegionScans just gets the count and returns S_OK
ULONG number = 0;
region->GetRegionScans(&number, NULL);
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP Édition Tablet PC [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
| DLL |
|