ValidateRgn-Funktion (winuser.h)
Die ValidateRgn-Funktion überprüft den Clientbereich innerhalb einer Region, indem die Region aus der aktuellen Updateregion des angegebenen Fensters entfernt wird.
Syntax
BOOL ValidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn
);
Parameter
[in] hWnd
Handle für das Fenster, dessen Updateregion geändert werden soll.
[in] hRgn
Handle für eine Region, die den Bereich definiert, der aus der Updateregion entfernt werden soll. Wenn dieser Parameter NULL ist, wird der gesamte Clientbereich entfernt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Die angegebene Region muss von einer Regionsfunktion erstellt worden sein. Es wird davon ausgegangen, dass es sich bei den Regionskoordinaten um Clientkoordinaten handelt.
Die BeginPaint-Funktion überprüft automatisch den gesamten Clientbereich. Weder die ValidateRect-Funktion noch die ValidateRgn-Funktion sollte aufgerufen werden, wenn ein Teil des Updatebereichs überprüft werden muss, bevor die nächste WM_PAINT Nachricht generiert wird.
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 | winuser.h (einschließlich Windows.h) |
Bibliothek | User32.lib |
DLL | User32.dll |
APIs | ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für