GetUpdateRgn-Funktion (winuser.h)
Die GetUpdateRgn-Funktion ruft den Updatebereich eines Fensters ab, indem sie ihn in den angegebenen Bereich kopiert. Die Koordinaten des Aktualisierungsbereichs sind relativ zur oberen linken Ecke des Fensters (d. a. es handelt sich um Clientkoordinaten).
Syntax
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Parameter
[in] hWnd
Handle für das Fenster mit einem Updatebereich, der abgerufen werden soll.
[in] hRgn
Handle für die Region, in der die Updateregion empfangen werden soll.
[in] bErase
Gibt an, ob der Fensterhintergrund gelöscht werden soll und ob Nichtclientbereiche untergeordneter Fenster gezeichnet werden sollen. Wenn dieser Parameter FALSE ist, wird keine Zeichnung durchgeführt.
Rückgabewert
Der Rückgabewert gibt die Komplexität des resultierenden Bereichs an. Dies kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
| KOMPLEXE REGION | Die Region besteht aus mehr als einem Rechteck. |
| ERROR | Ein Fehler ist aufgetreten. |
| NULLREGION | Region ist leer. |
| SIMPLEREGION | Region ist ein einzelnes Rechteck. |
Hinweise
Die BeginPaint-Funktion überprüft den Updatebereich automatisch, sodass jeder Aufruf von GetUpdateRgn , der unmittelbar nach dem Aufruf von BeginPaint erfolgt, 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) |