InvalidateRgn-Funktion (winuser.h)

Artikel
03/04/2024

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)