CreateEllipticRgn, fonction (wingdi.h)

  • Article

La fonction CreateEllipticRgn crée une région elliptique.

Syntaxe

HRGN CreateEllipticRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

Paramètres

[in] x1

Spécifie la coordonnée x en unités logiques du coin supérieur gauche du rectangle englobant de l’ellipse.

[in] y1

Spécifie la coordonnée y en unités logiques du coin supérieur gauche du rectangle englobant de l’ellipse.

[in] x2

Spécifie la coordonnée x en unités logiques, du coin inférieur droit du rectangle englobant de l’ellipse.

[in] y2

Spécifie la coordonnée y en unités logiques du coin inférieur droit du rectangle englobant de l’ellipse.

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.

Un rectangle englobant définit la taille, la forme et l’orientation de la région : les longs côtés du rectangle définissent la longueur de l’axe principal de l’ellipse ; les côtés courts définissent la longueur de l’axe secondaire de l’ellipse ; et le centre du rectangle définit l’intersection des axes principaux et secondaires.

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 wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

CreateEllipticRegnIndirect

DeleteObject

Fonctions de région

Vue d’ensemble des régions

SelectObject