GetUpdateRgn, fonction (winuser.h)

  • Article

La fonction GetUpdateRgn récupère la région de mise à jour d’une fenêtre en la copiant dans la région spécifiée. Les coordonnées de la région de mise à jour sont relatives au coin supérieur gauche de la fenêtre (c’est-à-dire, il s’agit de coordonnées clientes).

Syntaxe

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Paramètres

[in] hWnd

Gérez la fenêtre avec une région de mise à jour qui doit être récupérée.

[in] hRgn

Gérez la région pour recevoir la région de mise à jour.

[in] bErase

Spécifie si l’arrière-plan de la fenêtre doit être effacé et si les zones non clientes des fenêtres enfants doivent être dessinées. Si ce paramètre a la valeur FALSE, aucun dessin n’est effectué.

Valeur retournée

La valeur de retour indique la complexité de la région résultante ; il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
COMPLEXREGION La région se compose de plusieurs rectangles.
ERROR Une erreur est survenue.
NULLREGION La région est vide.
SIMPLEREGION La région est un rectangle unique.

Remarques

La fonction BeginPaint valide automatiquement la région de mise à jour. Par conséquent, tout appel à GetUpdateRgn effectué immédiatement après l’appel à BeginPaint récupère une région de mise à jour vide.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-draw-l1-1-0 (introduit dans Windows 8)

Voir aussi

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin