Partager via


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

Voir aussi

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

Fonctions de région

Vue d’ensemble des régions

SélectionnerObject