InvalidateRgn-Funktion (winuser.h)
Die InvalidateRgn-Funktion ungültigisiert den Clientbereich innerhalb der angegebenen Region, indem sie ihn dem aktuellen Updatebereich eines Fensters hinzufügt. Der ungültige Bereich wird zusammen mit allen anderen Bereichen im Aktualisierungsbereich zum Malen markiert, wenn die nächste WM_PAINT Nachricht auftritt.
Syntax
BOOL InvalidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parameter
[in] hWnd
Ein Handle für das Fenster mit einem Updatebereich, der geändert werden soll.
[in] hRgn
Ein Handle für die Region, die der Updateregion hinzugefügt werden soll. Es wird davon ausgegangen, dass die Region über Clientkoordinaten verfügt. Wenn dieser Parameter NULL ist, wird der gesamte Clientbereich der Updateregion hinzugefügt.
[in] bErase
Gibt an, ob der Hintergrund innerhalb der Updateregion gelöscht werden soll, wenn der Updatebereich verarbeitet wird. Wenn dieser Parameter TRUE ist, wird der Hintergrund gelöscht, wenn die BeginPaint-Funktion aufgerufen wird. Wenn der Parameter FALSE ist, bleibt der Hintergrund unverändert.
Rückgabewert
Der Rückgabewert ist immer nichtzero.
Hinweise
Ungültige Bereiche akkumulieren sich in der Updateregion, bis die nächste WM_PAINT Nachricht verarbeitet wird oder bis die Region mithilfe der ValidateRect - oder ValidateRgn-Funktion überprüft wird.
Das System sendet eine WM_PAINT Nachricht an ein Fenster, wenn dessen Updatebereich nicht leer ist und sich keine weiteren Nachrichten in der Anwendungswarteschlange für dieses Fenster befinden.
Die angegebene Region muss mithilfe einer der Regionsfunktionen erstellt worden sein.
Wenn der bErase-Parameter für einen Beliebigen Teil des Updatebereichs TRUE ist, wird der Hintergrund in der gesamten Region gelöscht, nicht nur im angegebenen Teil.
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) |