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 |