Freigeben über


CombineRgn-Funktion (wingdi.h)

Die CombineRgn-Funktion kombiniert zwei Regionen und speichert das Ergebnis in einer dritten Region. Die beiden Regionen werden entsprechend dem angegebenen Modus kombiniert.

Syntax

int CombineRgn(
  [in] HRGN hrgnDst,
  [in] HRGN hrgnSrc1,
  [in] HRGN hrgnSrc2,
  [in] int  iMode
);

Parameter

[in] hrgnDst

Ein Handle für eine neue Region mit Dimensionen, die durch die Kombination von zwei anderen Regionen definiert werden. (Diese Region muss vorhanden sein, bevor CombineRgn aufgerufen wird.)

[in] hrgnSrc1

Ein Handle für die erste von zwei Regionen, die kombiniert werden sollen.

[in] hrgnSrc2

Ein Handle für die zweite von zwei Regionen, die kombiniert werden sollen.

[in] iMode

Ein Modus, der angibt, wie die beiden Regionen kombiniert werden. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
RGN_AND
Erstellt die Schnittmenge der beiden kombinierten Regionen.
RGN_COPY
Erstellt eine Kopie der region, die von hrgnSrc1 identifiziert wurde.
RGN_DIFF
Kombiniert die Teile von hrgnSrc1 , die nicht Teil von hrgnSrc2 sind.
RGN_OR
Erstellt die Vereinigung von zwei kombinierten Regionen.
RGN_XOR
Erstellt die Vereinigung von zwei kombinierten Regionen mit Ausnahme von überlappenden Bereichen.

Rückgabewert

Der Rückgabewert gibt den Typ der resultierenden Region an. Dieses Argument einen der folgenden Werte annehmen.

Rückgabecode Beschreibung
NULLREGION
Die Region ist leer.
SIMPLEREGION
Die Region ist ein einzelnes Rechteck.
COMPLEXREGION
Die Region ist mehr als ein einzelnes Rechteck.
ERROR
Es wird keine Region erstellt.

Hinweise

Die drei Regionen müssen nicht voneinander getrennt sein. Beispielsweise kann der parameter hrgnSrc1 dem parameter hrgnDest entsprechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h (einschließlich Windows.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

Regionsfunktionen

Übersicht über Regionen