GetMetaRgn-Funktion (wingdi.h)

Artikel
08/27/2023

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

Weitere Informationen

Beschneidungsfunktionen

Übersicht über clipping

SetMetaRgn

Share via