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)

Weitere Informationen

Mal- und Zeichenfunktionen

Übersicht über Das Malen und Zeichnen