Graphics ::D rawPie(constPen*,INT,INT,INT,INT,REAL,REAL) , méthode (gdiplusgraphics.h)

Article
08/24/2023

La méthode Graphics ::D rawPie dessine un secteur.

Syntaxe

Status DrawPie(
  [in] const Pen *pen,
  [in] INT       x,
  [in] INT       y,
  [in] INT       width,
  [in] INT       height,
  [in] REAL      startAngle,
  [in] REAL      sweepAngle
);

Paramètres

[in] pen

Type : stylet* const

Pointeur vers un stylet utilisé pour dessiner le secteur.

[in] x

Type : INT

Entier qui spécifie la coordonnée x du coin supérieur gauche du rectangle qui limite l’ellipse dans laquelle dessiner le secteur.

[in] y

Type : INT

Entier qui spécifie la coordonnée y du coin supérieur gauche du rectangle qui limite l’ellipse dans laquelle dessiner le secteur.

[in] width

Type : INT

Entier qui spécifie la largeur du rectangle qui limite l’ellipse dans laquelle dessiner le secteur.

[in] height

Type : INT

Entier qui spécifie la hauteur du rectangle qui limite l’ellipse dans laquelle dessiner le secteur.

[in] startAngle

Type : REAL

Nombre réel qui spécifie l’angle, en degrés, entre l’axe x et le point de départ de l’arc qui définit le secteur. Une valeur positive spécifie la rotation dans le sens des aiguilles d’une montre.

[in] sweepAngle

Type : REAL

Nombre réel qui spécifie l’angle, en degrés, entre les points de départ et de fin de l’arc qui définit le secteur. Une valeur positive spécifie la rotation dans le sens des aiguilles d’une montre.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

L’illustration suivante montre le secteur qui est dessiné dans l’ellipse délimitée par le rectangle. L’illustration montre également l’axe horizontal de l’ellipse et la direction de l’ensemple et du balayageAngle.

Illustration montrant une ellipse avec un secteur en contour ; l’angle de début et l’angle de balayage sont étiquetés

Exemples

L’exemple suivant dessine un secteur.


VOID Example_DrawPie3(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Define the pie.
   int x = 0;
   int y = 0;
   int width = 200;
   int height = 100;
   REAL startAngle = 0.0f;
   REAL sweepAngle = 45.0f;

   // Draw the pie.
   graphics.DrawPie(&blackPen, x, y, width, height, startAngle, sweepAngle);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, 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	gdiplusgraphics.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll