Fonction Arc (wingdi.h)

Article
08/27/2023

La fonction Arc dessine un arc elliptique.

Syntaxe

BOOL Arc(
  [in] HDC hdc,
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2,
  [in] int x3,
  [in] int y3,
  [in] int x4,
  [in] int y4
);

Paramètres

[in] hdc

Handle du contexte d’appareil dans lequel le dessin a lieu.

[in] x1

Coordonnée x, en unités logiques, du coin supérieur gauche du rectangle englobant.

[in] y1

Coordonnée y, en unités logiques, du coin supérieur gauche du rectangle englobant.

[in] x2

Coordonnée x, en unités logiques, du coin inférieur droit du rectangle englobant.

[in] y2

Coordonnée y, en unités logiques, du coin inférieur droit du rectangle englobant.

[in] x3

Coordonnée x, en unités logiques, du point de fin de la ligne radiale définissant le point de départ de l’arc.

[in] y3

Coordonnée y, en unités logiques, du point de fin de la ligne radiale définissant le point de départ de l’arc.

[in] x4

Coordonnée x, en unités logiques, du point de terminaison de la ligne radiale définissant le point de fin de l’arc.

[in] y4

Coordonnée y, en unités logiques, du point de terminaison de la ligne radiale définissant le point de fin de l’arc.

Valeur retournée

Si l’arc est dessiné, la valeur de retour est différente de zéro.

Si l’arc n’est pas dessiné, la valeur de retour est zéro.

Remarques

Les points (nLeftRect, nTopRect) et (nRightRect, nBottomRect) spécifient le rectangle englobant. Une ellipse formée par le rectangle englobant spécifié définit la courbe de l’arc. L’arc s’étend dans le sens de dessin actuel à partir du point où il croise le radial du centre du rectangle englobant au point (nXStartArc, nYStartArc). L’arc se termine là où il croise le radial du centre du rectangle englobant au point (nXEndArc, nYEndArc). Si le point de départ et le point de fin sont identiques, une ellipse complète est dessinée.

L’arc est dessiné à l’aide du stylet actuel ; il n’est pas rempli.

La position actuelle n’est ni utilisée ni mise à jour par Arc.

Utilisez les fonctions GetArcDirection et SetArcDirection pour obtenir et définir le sens de dessin actuel pour un contexte d’appareil. Le sens du dessin par défaut est dans le sens inverse des aiguilles d’une montre.

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