GetUpdateRect-Funktion (winuser.h)

Artikel
08/27/2023

Die GetUpdateRect-Funktion ruft die Koordinaten des kleinsten Rechtecks ab, das den Updatebereich des angegebenen Fensters vollständig umschließt. GetUpdateRect ruft das Rechteck in logischen Koordinaten ab. Wenn kein Updatebereich vorhanden ist, ruft GetUpdateRect ein leeres Rechteck ab (legt alle Koordinaten auf Null fest).

Syntax

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

Parameter

[in] hWnd

Handle für das Fenster, dessen Updatebereich abgerufen werden soll.

[out] lpRect

Zeiger auf die RECT-Struktur , die die Koordinaten des umgebenden Rechtecks in Geräteeinheiten empfängt.

Eine Anwendung kann diesen Parameter auf NULL festlegen, um zu bestimmen, ob ein Updatebereich für das Fenster vorhanden ist. Wenn dieser Parameter NULL ist, gibt GetUpdateRect ungleich null zurück, wenn ein Updatebereich vorhanden ist, und null, wenn dies nicht der Fall ist. Dies bietet eine einfache und effiziente Möglichkeit, zu bestimmen, ob eine WM_PAINT Nachricht aus einem ungültigen Bereich resultiert.

[in] bErase

Gibt an, ob der Hintergrund im Updatebereich gelöscht werden soll. Wenn dieser Parameter TRUE ist und der Updatebereich nicht leer ist, sendet GetUpdateRect eine WM_ERASEBKGND Meldung an das angegebene Fenster, um den Hintergrund zu löschen.

Rückgabewert

Wenn der Updatebereich nicht leer ist, ist der Rückgabewert ungleich null.

Wenn kein Updatebereich vorhanden ist, ist der Rückgabewert 0(0).

Hinweise

Das von der BeginPaint-Funktion abgerufene Updaterechteck ist identisch mit dem von GetUpdateRect abgerufenen Rechteck.

BeginPaint überprüft den Updatebereich automatisch, sodass jeder Aufruf von GetUpdateRect unmittelbar nach dem Aufruf von BeginPaint einen leeren Updatebereich abruft.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8)