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	IACom.h (erfordert auch IACom_i.c)
DLL	IACom.dll

Weitere Informationen

IAnalysisRegion

IAnalysisRegion::GetBounds-Methode

Freihandanalysereferenz