CombineRgn-Funktion (wingdi.h)

Artikel
03/13/2024

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