GetUpdateRgn, fonction (winuser.h)
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) |