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 |
|---|---|
|
Region ist leer. |
|
Region ist ein einzelnes Rechteck. |
|
Region ist mehr als ein Rechteck. |
|
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 |