Regionsfunktionen (GDI+)

Windows GDI+ macht eine flache API verfügbar, die aus ca. 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert sind. Die Funktionen in der GDI+-Flach-API werden durch eine Auflistung von ca. 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt aufzurufen. Wenn Sie Aufrufe an GDI+ tätigen, sollten Sie dies tun, indem Sie die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Microsoft-Produktsupportdienste bieten keine Unterstützung für Code, der die flache API direkt aufruft. Weitere Informationen zur Verwendung dieser Wrappermethoden finden Sie unter GDI+ Flat API.

Die folgenden flachen API-Funktionen werden von der Region C++-Klasse umschlossen.

Regionsfunktionen und entsprechende Wrappermethoden

Flache Funktion	Wrapper-Methode	Bemerkungen
GpStatus WINGDIPAPI GdipCreateRegion(GpRegion **region)	Region::Region()	Erstellt einen Bereich, der unendlich ist. Dies ist der Standardkonstruktor.
GpStatus WINGDIPAPI GdipCreateRegionRect(GDIPCONST GpRectF *rect, GpRegion **region)	Region::Region(IN const RectF& rect)	Erstellt einen Bereich, der durch ein Rechteck definiert wird.
GpStatus WINGDIPAPI GdipCreateRegionRectI(GDIPCONST GpRect *rect, GpRegion **region)	Region::Region(IN const Rect& rect)	Erstellt einen Bereich, der durch ein Rechteck definiert wird.
GpStatus WINGDIPAPI GdipCreateRegionPath(GpPath *path, GpRegion **region)	Region::Region(IN const GraphicsPath*-Pfad)	Erstellt einen Bereich, der durch ein GraphicsPath -Objekt definiert wird und einen Füllmodus aufweist, der im GraphicsPath -Objekt enthalten ist.
GpStatus WINGDIPAPI GdipCreateRegionRgnData(GDIPCONST BYTE *regionData, INT size, GpRegion **region)	Region::Region(IN const BYTE* regionData, INT size)	Erstellt eine Region, die durch Daten definiert wird, die aus einer anderen Region abgerufen wurden.
GpStatus WINGDIPAPI GdipCreateRegionHrgn(HRGN hRgn, GpRegion **region)	Region::Region(IN HRGN hRgn)	Erstellt eine Region, die mit dem Bereich identisch ist, der durch ein Handle für eine GDI-Region angegeben wird.
GpStatus WINGDIPAPI GdipCloneRegion(GpRegion *region, GpRegion **cloneRegion)	Region* Region::Clone() const	Erstellt eine Kopie dieses Region -Objekts und gibt die Adresse des neuen Region -Objekts zurück.
GpStatus WINGDIPAPI GdipDeleteRegion(GpRegion *region)	Region::~Region()	Gibt Ressourcen frei, die vom Region-Objekt verwendet werden.
GpStatus WINGDIPAPI GdipSetInfinite(GpRegion *region)	Statusregion::MakeInfinite()	Aktualisiert diese Region auf eine unendliche Region.
GpStatus WINGDIPAPI GdipSetEmpty(GpRegion *region)	Statusregion::MakeEmpty()	Aktualisiert diese Region auf eine leere Region. Mit anderen Worten, der Bereich belegt keinen Platz auf dem Anzeigegerät.
GpStatus WINGDIPAPI GdipCombineRegionRect(GpRegion *region, GDIPCONST GpRectF *rect, CombineMode combineMode)	Statusbereich::Intersect(IN const RectF& rect)	Aktualisiert diesen Bereich auf den Teil von sich selbst, der das Innere des angegebenen Rechtecks überschneidet. Der combineMode Parameter in der flachen Funktion ist ein Element der CombineMode- Enumeration, die angibt, wie der Bereich und das Rechteck kombiniert werden.
GpStatus WINGDIPAPI GdipCombineRegionRectI(GpRegion *region, GDIPCONST GpRect *rect, CombineMode combineMode)	Statusbereich::Intersect(IN const Rect& rect)	Aktualisiert diesen Bereich auf den Teil von sich selbst, der das Innere des angegebenen Rechtecks überschneidet. Der combineMode Parameter in der flachen Funktion ist ein Element der CombineMode- Enumeration, die angibt, wie der Bereich und das Rechteck kombiniert werden.
GpStatus WINGDIPAPI GdipCombineRegionPath(GpRegion *region, GpPath *path, CombineMode combineMode)	Statusregion::Intersect(IN const GraphicsPath*-Pfad)	Aktualisiert diesen Bereich auf den Teil von sich selbst, der das Innere des angegebenen Pfads überschneidet. Der combineMode Parameter in der flachen Funktion ist ein Element der CombineMode Enumeration, die angibt, wie der Bereich und der Pfad kombiniert werden.
GpStatus WINGDIPAPI GdipCombineRegion(GpRegion *region, GpRegion *region2, CombineMode combineMode)	Region::Intersect(IN const Region* Region)	Aktualisiert diesen Bereich auf den Teil von sich selbst, der eine andere Region überschneidet. Der combineMode Parameter in der flachen Funktion ist ein Element der CombineMode Enumeration, die angibt, wie die Regionen kombiniert werden.
GpStatus WINGDIPAPI GdipTranslateRegion(GpRegion *region, REAL dx, REAL dy)	Region::Translate(IN REAL dx, IN REAL dy)	Versetzt diesen Bereich um angegebene Beträge in horizontaler und vertikaler Richtung.
GpStatus WINGDIPAPI GdipTranslateRegionI(GpRegion *region, INT dx, INT dy)	Statusregion::Translate(INT dx, INT dy)	Versetzt diesen Bereich um angegebene Beträge in horizontaler und vertikaler Richtung.
GpStatus WINGDIPAPI GdipTransformRegion(GpRegion *region, GpMatrix *matrix)	Region::Transform(IN const Matrix*-Matrix)	Transformiert diesen Bereich durch Multiplizieren der einzelnen Datenpunkte mit einer angegebenen Matrix.
GpStatus WINGDIPAPI GdipGetRegionBounds(GpRegion *region, GpGraphics *graphics, GpRectF *rect)	Statusregion::GetBounds(OUT RectF* rect* rect, IN const Graphics* g) const	Ruft ein Rechteck ab, das diesen Bereich einschließt.
GpStatus WINGDIPAPI GdipGetRegionBoundsI(GpRegion *region, GpGraphics *graphics, GpRect *rect)	Statusregion::GetBounds(OUT Rect* rect*rect, IN const Graphics* g) const	Ruft ein Rechteck ab, das diesen Bereich einschließt.
GpStatus WINGDIPAPI GdipGetRegionHRgn(GpRegion *region, GpGraphics *graphics, HRGN *hRgn)	HRGN Region::GetHRGN(IN const Graphics* g) const	Erstellt eine GDI-Region aus dieser Region.
GpStatus WINGDIPAPI GdipIsEmptyRegion(GpRegion *region, GpGraphics *graphics, BOOL *result)	BOOL Region::IsEmpty(IN const Graphics *g)const	Bestimmt, ob dieser Bereich leer ist.
GpStatus WINGDIPAPI GdipIsInfiniteRegion(GpRegion *region, GpGraphics *graphics, BOOL *result)	BOOL Region::IsInfinite(IN const Graphics *g)const	Bestimmt, ob dieser Bereich unendlich ist.
GpStatus WINGDIPAPI GdipIsEqualRegion(GpRegion *region, GpRegion *region2, GpGraphics *graphics, BOOL *result)	BOOL Region::Equals(IN const Region* Region* Region, IN const Graphics* g) const	Bestimmt, ob dieser Bereich einem angegebenen Bereich entspricht.
GpStatus WINGDIPAPI GdipGetRegionDataSize(GpRegion *region, UINT * bufferSize)	UINT Region::GetDataSize() const	Ruft die Anzahl der Bytes von Daten ab, die diese Region beschreiben.
GpStatus WINGDIPAPI GdipGetRegionData(GpRegion *region, BYTE * puffer, UINT bufferSize, UINT * sizeFilled)	Statusregion::GetData(OUT BYTE* buffer, IN UINT bufferSize, OUT UINT* sizeFilled) const	Ruft Daten ab, die diese Region beschreiben.
GpStatus WINGDIPAPI GdipIsVisibleRegionPoint(GpRegion *region, REAL x, REAL y, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const PointF& Punkt, IN const Graphics* g) const	Bestimmt, ob sich ein Punkt innerhalb dieses Bereichs befindet. Die parameter x und y in der flachen Funktion geben die X- und Y-Koordinaten eines Punkts an, der dem Punkt Parameter in der Wrappermethode entspricht.
GpStatus WINGDIPAPI GdipIsVisibleRegionPointI(GpRegion *region, INT x, INT y, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const Point& Punkt, IN const Graphics* g) const	Bestimmt, ob sich ein Punkt innerhalb dieses Bereichs befindet. Die parameter x und y in der flachen Funktion geben die X- und Y-Koordinaten eines Punkts an, der dem Punkt Parameter in der Wrappermethode entspricht.
GpStatus WINGDIPAPI GdipIsVisibleRegionRect(GpRegion *region, REAL x, REAL y, REAL width, REAL height, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const RectF& rect, IN const Graphics* g) const	Bestimmt, ob ein Rechteck diesen Bereich überschneidet. Die x, y, Breiteund Höhe Parameter in der flachen Funktion geben ein Rechteck an, das dem Rechteck Parameter in der Wrappermethode entspricht.
GpStatus WINGDIPAPI GdipIsVisibleRegionRectI(GpRegion *region, INT x, INT y, INT width, INT height, GpGraphics *graphics, BOOL *result)	BOOL Region::IsVisible(IN const Rect& rect, IN const Graphics* g) const	Bestimmt, ob ein Rechteck diesen Bereich überschneidet. Die x, y, Breiteund Höhe Parameter in der flachen Funktion geben ein Rechteck an, das dem Rechteck Parameter in der Wrappermethode entspricht.
GpStatus WINGDIPAPI GdipGetRegionScansCount(GpRegion *region, UINT* count, GpMatrix* matrix)	UINT Region::GetRegionScansCount(IN const Matrix* matrix) const	Ruft die Anzahl der Rechtecke ab, die diesen Bereich annähern. Der Bereich wird durch eine angegebene Matrix transformiert, bevor die Rechtecke berechnet werden.
GpStatus WINGDIPAPI GdipGetRegionScans(GpRegion *region, GpRectF* rects, INT* count, GpMatrix* matrix)	Statusregion::GetRegionScans( IN const Matrix* matrix, OUT RectF* rects, IN OUT INT* count) const	Ruft ein Array von Rechtecke ab, die dieser Region nähern. Der Bereich wird durch eine angegebene Matrix transformiert, bevor die Rechtecke berechnet werden.
GpStatus WINGDIPAPI GdipGetRegionScansI(GpRegion *region, GpRect* rects, INT* count, GpMatrix* matrix)	Statusregion::GetRegionScans( IN const Matrix* matrix, OUT Rect* rects, IN OUT INT* count) const	Ruft ein Array von Rechtecke ab, die dieser Region nähern. Der Bereich wird durch eine angegebene Matrix transformiert, bevor die Rechtecke berechnet werden.