GetRandomRgn-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetRandomRgn-Funktion kopiert den Systemausschnittbereich eines angegebenen Gerätekontexts in eine bestimmte Region.

Syntax

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] hrgn

Ein Handle für eine Region. Bevor die Funktion aufgerufen wird, identifiziert dies eine vorhandene Region. Nachdem die Funktion zurückgegeben wurde, identifiziert diese eine Kopie des aktuellen Systembereichs. Die alte Region, die von hrgn identifiziert wird, wird überschrieben.

[in] i

Dieser Parameter muss SYSRGN sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert 1. Wenn die Funktion fehlschlägt, ist der Rückgabewert -1. Wenn der abzurufende Bereich NULL ist, ist der Rückgabewert 0. Wenn die Funktion fehlschlägt oder der abzurufende Bereich NULL ist, wird hrgn nicht initialisiert.

Hinweise

Beachten Sie bei Verwendung des SYSRGN-Flags, dass der Systemausschnittbereich aufgrund von Fensterverschiebungen möglicherweise nicht aktuell ist. Dennoch ist es sicher, den Systemausschnittbereich innerhalb des BeginPaint-EndPaint-Blocks während WM_PAINT Verarbeitung abzurufen und zu verwenden. In diesem Fall ist der Systembereich die Schnittmenge des Updatebereichs und des aktuellen sichtbaren Bereichs des Fensters. Jede Fensterverschiebung nach der Rückgabe von GetRandomRgn und vor EndPaint führt zu einer neuen WM_PAINT Meldung. Jede andere Verwendung des SYSRGN-Flags kann zu Malfehlern in Ihrer Anwendung führen.

Der zurückgegebene Bereich befindet sich in Bildschirmkoordinaten.

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