CreateRectRgn, fonction (wingdi.h)
La fonction CreateRectRgn crée une région rectangulaire.
Syntaxe
HRGN CreateRectRgn(
[in] int x1,
[in] int y1,
[in] int x2,
[in] int y2
);
Paramètres
[in] x1
Spécifie la coordonnée x du coin supérieur gauche de la région en unités logiques.
[in] y1
Spécifie la coordonnée y du coin supérieur gauche de la région en unités logiques.
[in] x2
Spécifie la coordonnée x du coin inférieur droit de la région en unités logiques.
[in] y2
Spécifie la coordonnée y du coin inférieur droit de la région en unités logiques.
Valeur retournée
Si la fonction réussit, la valeur de retour est le handle de la région.
Si la fonction échoue, la valeur de retour est NULL.
Remarques
Lorsque vous n’avez plus besoin de l’objet HRGN , appelez la fonction DeleteObject pour le supprimer.
Les coordonnées de région sont représentées sous forme d’entiers signés 27 bits.
Les régions créées par les méthodes Create<shape>Rgn (telles que CreateRectRgn et CreatePolygonRgn) incluent uniquement l’intérieur de la forme ; le contour de la forme est exclu de la région. Cela signifie que tout point sur une ligne entre deux sommets séquentiels n’est pas inclus dans la région. Si vous deviez appeler PtInRegion pour un tel point, il retournerait zéro comme résultat.
Exemples
Pour obtenir un exemple, consultez Marqueurs de dessin.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | wingdi.h (inclure Windows.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |