CreateRectRgn, fonction (wingdi.h)

Article
08/27/2023

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