InvalidateRect-Funktion (winuser.h)

Artikel
08/27/2023

Die InvalidateRect-Funktion fügt dem Updatebereich des angegebenen Fensters ein Rechteck hinzu. Der Updatebereich stellt den Teil des Clientbereichs des Fensters dar, der neu gezeichnet werden muss.

Syntax

BOOL InvalidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect,
  [in] BOOL       bErase
);

Parameter

[in] hWnd

Ein Handle für das Fenster, dessen Updatebereich geändert wurde. Wenn dieser Parameter NULL ist, wird vom System alle Fenster ungültig und neu gezeichnet, nicht nur die Fenster für diese Anwendung, und sendet die WM_ERASEBKGND - und WM_NCPAINT-Nachrichten , bevor die Funktion zurückgegeben wird. Das Festlegen dieses Parameters auf NULL wird nicht empfohlen.

[in] lpRect

Ein Zeiger auf eine RECT-Struktur , die die Clientkoordinaten des Rechtecks enthält, das dem Updatebereich hinzugefügt werden soll. 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 dieser Parameter FALSE ist, bleibt der Hintergrund unverändert.

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 ungültigen Bereiche werden in der Aktualisierungsregion gesammelt, bis die Region verarbeitet wird, wenn die nächste WM_PAINT Nachricht auftritt 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.

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.

Beispiele

Ein Beispiel finden Sie unter Ungültig erklären des Clientbereichs.

Anforderungen


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 (in Windows 8 eingeführt)