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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour