GetMetaRgn-Funktion (wingdi.h)
Die GetMetaRgn-Funktion ruft die aktuelle Metaregion für den angegebenen Gerätekontext ab.
Syntax
int GetMetaRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] hrgn
Ein Handle für einen vorhandenen Bereich, bevor die Funktion aufgerufen wird. Nachdem die Funktion zurückgegeben wurde, ist dieser Parameter ein Handle für eine Kopie der aktuellen Metaregion.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Wenn die Funktion erfolgreich ist, ist hrgn ein Handle für eine Kopie der aktuellen Metaregion. Nachfolgende Änderungen an dieser Kopie wirken sich nicht auf die aktuelle Metaregion aus.
Der aktuelle Beschneidungsbereich eines Gerätekontexts wird durch die Schnittmenge seines Beschneidungsbereichs und seiner Metaregion definiert.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |