GetUpdateRect-Funktion (winuser.h)
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) |