IAnalysisRegion::GetRegionScans-Methode
Ruft ein Array von Rechtecke ab, das den Bereich von IAnalysisRegiondefiniert.
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 Rechtecke, das den Bereich von IAnalysisRegiondefiniert.
Rückgabewert
Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Ink-Analyse.
Bemerkungen
Wenn pRegionScans als NULL übergeben wird, gibt die GetRegionScans-Methode S _ OK zurück, und die Anzahl der Rechtecke wird in pulCount zurückgegeben.
Achtung
Um einen Speicherverlust zu vermeiden, verwenden Sie CoTaskMemFree, um den Arbeitsspeicher von * pRegionScans freizugeben, wenn Sie die Informationen nicht mehr benötigen.
Die Begrenzungen der Rechtecke befinden sich in Freihandraumkoordinaten.
Die Vereinigung der zurückgegebenen Rechtecke stellt den Bereich des IAnalysisRegiondar.
Beispiele
Das folgende Beispiel zeigt, wie Die Rechtecke, die den Bereich von IAnalysisRegiondefinieren, region und 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);
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur Desktop-Apps der XP Tablet PC Edition [] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|