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 (autrement dit, elles sont des 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 à récupérer.
[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 nonclient des fenêtres enfants doivent être dessinées. Si ce paramètre est FALSE, aucun dessin n’est terminé.
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) |