IAnalysisRegion::GetRegionScans-Methode
Ruft ein Array von Rechtecken ab, das den Bereich der IAnalysisRegion definiert.
Syntax
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
Parameter
-
pulCount [out]
-
Die Anzahl der in pRegionScans zurückgegebenen Rechtecke.
-
pRegionScans [out]
-
Ein Zeiger auf ein Array von Rechtecken, das den Bereich der IAnalysisRegion definiert.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.
Bemerkungen
Wenn pRegionScans als NULL übergeben wird, gibt die GetRegionScans-MethodeS_OK zurück, und die Anzahl der Rechtecke wird in pulCount zurückgegeben.
Achtung
Um einen Speicherverlust zu vermeiden, verwenden Sie CoTaskMemFree , um den Speicher von *pRegionScans freizugeben, wenn Sie die Informationen nicht mehr benötigen.
Die Grenzen der Rechtecke befinden sich in Freiraumkoordinaten.
Die Union der zurückgegebenen Rechtecke stellt den Bereich der IAnalysisRegion dar.
Beispiele
Das folgende Beispiel zeigt, wie Sie die Rechtecke abrufen, die den Bereich der IAnalysisRegion definieren, region und wie Sie nur die Anzahl der Rechtecke abrufen.
// 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);
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|