SetMetaRgn-Funktion (wingdi.h)

Die SetMetaRgn-Funktion überschneidet den aktuellen Abschneidebereich für den angegebenen Gerätekontext mit der aktuellen Metaregion und speichert die kombinierte Region als neue Metaregion für den angegebenen Gerätekontext. Der Abschneidebereich wird auf einen NULL-Bereich zurückgesetzt.

Syntax

int SetMetaRgn(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Rückgabewert

Der Rückgabewert gibt die Komplexität des neuen Abschneidebereichs an und kann einer der folgenden Werte sein.

Rückgabecode	Beschreibung
NULLREGION	Region ist leer.
SIMPLEREGION	Region ist ein einzelnes Rechteck.
COMPLEXREGION	Region ist mehr als ein Rechteck.
ERROR	Ein Fehler ist aufgetreten. (Der vorherige Beschneidungsbereich ist nicht betroffen.)

Hinweise

Der aktuelle Beschneidungsbereich eines Gerätekontexts wird durch die Schnittmenge zwischen dem Beschneidungsbereich und der Metaregion definiert.

Die SetMetaRgn-Funktion sollte nur aufgerufen werden, nachdem der ursprüngliche Gerätekontext einer Anwendung durch Aufrufen der SaveDC-Funktion gespeichert wurde.

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

Beschneidungsfunktionen

Übersicht über das Clipping

GetMetaRgn

SaveDC