Fonction AngleArc (wingdi.h)

Article
03/04/2024

La fonction AngleArc dessine un segment de ligne et un arc. Le segment de ligne est dessiné de la position actuelle au début de l’arc. L’arc est dessiné le long du périmètre d’un cercle avec le rayon et le centre donnés. La longueur de l’arc est définie par les angles de début et de balayage donnés.

Syntaxe

BOOL AngleArc(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] DWORD r,
  [in] FLOAT StartAngle,
  [in] FLOAT SweepAngle
);

Paramètres

[in] hdc

Handle vers un contexte de périphérique.

[in] x

Spécifie la coordonnée x, en unités logiques, du centre du cercle.

[in] y

Spécifie la coordonnée y, en unités logiques, du centre du cercle.

[in] r

Spécifie le rayon, en unités logiques, du cercle. Cette valeur doit être positive.

[in] StartAngle

Spécifie l’angle de début, en degrés, par rapport à l’axe X.

[in] SweepAngle

Spécifie l’angle de balayage, en degrés, par rapport à l’angle de départ.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La fonction AngleArc déplace la position actuelle vers le point de terminaison de l’arc.

L’arc dessiné par cette fonction peut sembler elliptique, en fonction du mode de transformation et de mappage actuel. Avant de dessiner l’arc, AngleArc dessine le segment de trait de la position actuelle jusqu’au début de l’arc.

L’arc est dessiné en construisant un cercle imaginaire autour du point central spécifié avec le rayon spécifié. Le point de départ de l’arc est déterminé en mesurant dans le sens inverse des aiguilles d’une montre à partir de l’axe X du cercle le nombre de degrés dans l’angle de départ. Le point de fin est également localisé en mesurant dans le sens inverse des aiguilles d’une montre à partir du point de départ le nombre de degrés dans l’angle de balayage.

Si l’angle de balayage est supérieur à 360 degrés, l’arc est balayé plusieurs fois.

Cette fonction dessine des lignes à l’aide du stylet actuel. La figure n’est pas remplie.

Exemples

Pour obtenir un exemple, consultez Dessin d’un graphique à secteurs.

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