Freigeben über


GetRandomRgn-Funktion (wingdi.h)

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-Blockswä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

Weitere Informationen

BeginPaint

Beschneidungsfunktionen

Übersicht über clipping

EndPaint

ExtSelectClipRgn

GetClipBox

GetClipRgn

GetRegionData

OffsetRgn