Freigeben über


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