Graphics.DrawPie Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Dessine un secteur défini par une ellipse spécifiée par une paire de coordonnées, une largeur, une hauteur et deux lignes radiales.

Surcharges

DrawPie(Pen, Rectangle, Single, Single)	Dessine un secteur défini par une ellipse spécifiée par une structure Rectangle et deux lignes radiales.
DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32)	Dessine un secteur défini par une ellipse spécifiée par une paire de coordonnées, une largeur, une hauteur et deux lignes radiales.
DrawPie(Pen, Single, Single, Single, Single, Single, Single)	Dessine un secteur défini par une ellipse spécifiée par une paire de coordonnées, une largeur, une hauteur et deux lignes radiales.
DrawPie(Pen, RectangleF, Single, Single)	Dessine un secteur défini par une ellipse spécifiée par une structure RectangleF et deux lignes radiales.

DrawPie(Pen, Rectangle, Single, Single)

Source:

Graphics.cs

Dessine un secteur défini par une ellipse spécifiée par une structure Rectangle et deux lignes radiales.

public:
 void DrawPie(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect, float startAngle, float sweepAngle);

public void DrawPie (System.Drawing.Pen pen, System.Drawing.Rectangle rect, float startAngle, float sweepAngle);

member this.DrawPie : System.Drawing.Pen * System.Drawing.Rectangle * single * single -> unit

Public Sub DrawPie (pen As Pen, rect As Rectangle, startAngle As Single, sweepAngle As Single)

Paramètres

pen

Pen

Pen qui détermine la couleur, la largeur et le style du secteur.

rect

Rectangle

Structure Rectangle qui représente le rectangle englobant qui définit l'ellipse d'où est issu le secteur.

startAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir de l'axe x jusqu'au premier coté du secteur.

sweepAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir du paramètre startAngle jusqu'au deuxième coté du secteur.

Exceptions

ArgumentNullException

pen a la valeur null.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée un stylet noir.

• Crée un rectangle qui limite une ellipse complète.

• Définit les angles auxquels commencer le dessin (par rapport à l’axe X) et à travers lesquels dessiner (les deux dans le sens des aiguilles d’une montre).

• Dessine le segment en secteurs vers l’écran.

public:
   void DrawPieRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle for ellipse.
      Rectangle rect = Rectangle(0,0,200,100);

      // Create start and sweep angles.
      float startAngle = 0.0F;
      float sweepAngle = 45.0F;

      // Draw pie to screen.
      e->Graphics->DrawPie( blackPen, rect, startAngle, sweepAngle );
   }

public void DrawPieRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle for ellipse.
    Rectangle rect = new Rectangle(0, 0, 200, 100);
             
    // Create start and sweep angles.
    float startAngle =  0.0F;
    float sweepAngle = 45.0F;
             
    // Draw pie to screen.
    e.Graphics.DrawPie(blackPen, rect, startAngle, sweepAngle);
}

Public Sub DrawPieRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle for ellipse.
    Dim rect As New Rectangle(0, 0, 200, 100)

    ' Create start and sweep angles.
    Dim startAngle As Single = 0.0F
    Dim sweepAngle As Single = 45.0F

    ' Draw pie to screen.
    e.Graphics.DrawPie(blackPen, rect, startAngle, sweepAngle)
End Sub

Remarques

Cette méthode dessine une forme en secteurs définie par un arc d’une ellipse et les deux lignes radiales qui se croisent avec les points de terminaison de l’arc. L’ellipse est définie par le rectangle englobant. La forme de secteurs se compose des deux lignes radiales définies par les startAngle paramètres et sweepAngle et de l’arc entre les intersections de ces lignes radiales avec l’ellipse.

Si le sweepAngle paramètre est supérieur à 360 degrés ou inférieur à -360 degrés, il est traité comme s’il était à 360 degrés ou -360 degrés, respectivement.

DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32)

Source:

Graphics.cs

Dessine un secteur défini par une ellipse spécifiée par une paire de coordonnées, une largeur, une hauteur et deux lignes radiales.

public:
 void DrawPie(System::Drawing::Pen ^ pen, int x, int y, int width, int height, int startAngle, int sweepAngle);

public void DrawPie (System.Drawing.Pen pen, int x, int y, int width, int height, int startAngle, int sweepAngle);

member this.DrawPie : System.Drawing.Pen * int * int * int * int * int * int -> unit

Public Sub DrawPie (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer, startAngle As Integer, sweepAngle As Integer)

Paramètres

pen

Pen

Pen qui détermine la couleur, la largeur et le style du secteur.

x

Int32

Coordonnée x de l'angle supérieur gauche du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

y

Int32

Coordonnée x de l'angle supérieur gauche du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

width

Int32

Largeur du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

height

Int32

Hauteur du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

startAngle

Int32

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir de l'axe x jusqu'au premier coté du secteur.

sweepAngle

Int32

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir du paramètre startAngle jusqu'au deuxième coté du secteur.

Exceptions

ArgumentNullException

pen a la valeur null.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée un stylet noir.

• Crée la position et la taille d’un rectangle qui limite une ellipse complète.

• Définit les angles auxquels commencer le dessin (par rapport à l’axe X) et à travers lesquels dessiner (les deux dans le sens des aiguilles d’une montre).

• Dessine la forme de secteurs à l’écran.

public:
   void DrawPieInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of ellipse.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 100;

      // Create start and sweep angles.
      int startAngle = 0;
      int sweepAngle = 45;

      // Draw pie to screen.
      e->Graphics->DrawPie( blackPen, x, y, width, height, startAngle, sweepAngle );
   }

public void DrawPieInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of ellipse.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 100;
             
    // Create start and sweep angles.
    int startAngle =  0;
    int sweepAngle = 45;
             
    // Draw pie to screen.
    e.Graphics.DrawPie(blackPen, x, y, width, height, startAngle, sweepAngle);
}

Public Sub DrawPieInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of ellipse.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 100

    ' Create start and sweep angles.
    Dim startAngle As Integer = 0
    Dim sweepAngle As Integer = 45

    ' Draw pie to screen.
    e.Graphics.DrawPie(blackPen, x, y, width, height, _
    startAngle, sweepAngle)
End Sub

Remarques

Cette méthode dessine une forme en secteurs définie par un arc d’une ellipse et les deux lignes radiales qui se croisent avec les points de terminaison de l’arc. L’ellipse est définie par le rectangle englobant décrit par les xparamètres , y, widthet height . La forme de secteurs se compose des deux lignes radiales définies par les startAngle paramètres et sweepAngle et de l’arc entre les intersections de ces lignes radiales avec l’ellipse.

Si le sweepAngle paramètre est supérieur à 360 degrés ou inférieur à -360 degrés, il est traité comme s’il était à 360 degrés ou -360 degrés, respectivement.

DrawPie(Pen, Single, Single, Single, Single, Single, Single)

Source:

Graphics.cs

Dessine un secteur défini par une ellipse spécifiée par une paire de coordonnées, une largeur, une hauteur et deux lignes radiales.

public:
 void DrawPie(System::Drawing::Pen ^ pen, float x, float y, float width, float height, float startAngle, float sweepAngle);

public void DrawPie (System.Drawing.Pen pen, float x, float y, float width, float height, float startAngle, float sweepAngle);

member this.DrawPie : System.Drawing.Pen * single * single * single * single * single * single -> unit

Public Sub DrawPie (pen As Pen, x As Single, y As Single, width As Single, height As Single, startAngle As Single, sweepAngle As Single)

Paramètres

pen

Pen

Pen qui détermine la couleur, la largeur et le style du secteur.

x

Single

Coordonnée x de l'angle supérieur gauche du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

y

Single

Coordonnée x de l'angle supérieur gauche du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

width

Single

Largeur du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

height

Single

Hauteur du rectangle englobant qui définit l'ellipse d'où est issu le secteur.

startAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir de l'axe x jusqu'au premier coté du secteur.

sweepAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir du paramètre startAngle jusqu'au deuxième coté du secteur.

Exceptions

ArgumentNullException

pen a la valeur null.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée un stylet noir.

• Crée la position et la taille d’un rectangle qui limite une ellipse complète.

• Définit les angles auxquels commencer le dessin (par rapport à l’axe X) et à travers lesquels dessiner (les deux dans le sens des aiguilles d’une montre).

• Dessine le segment en secteurs vers l’écran.

public:
   void DrawPieFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of ellipse.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 100.0F;

      // Create start and sweep angles.
      float startAngle = 0.0F;
      float sweepAngle = 45.0F;

      // Draw pie to screen.
      e->Graphics->DrawPie( blackPen, x, y, width, height, startAngle, sweepAngle );
   }

public void DrawPieFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of ellipse.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 100.0F;
             
    // Create start and sweep angles.
    float startAngle =  0.0F;
    float sweepAngle = 45.0F;
             
    // Draw pie to screen.
    e.Graphics.DrawPie(blackPen, x, y, width, height, startAngle, sweepAngle);
}

Public Sub DrawPieFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of ellipse.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 100.0F

    ' Create start and sweep angles.
    Dim startAngle As Single = 0.0F
    Dim sweepAngle As Single = 45.0F

    ' Draw pie to screen.
    e.Graphics.DrawPie(blackPen, x, y, width, height, _
    startAngle, sweepAngle)
End Sub

Remarques

Cette méthode dessine une forme en secteurs définie par un arc d’une ellipse et les deux lignes radiales qui se croisent avec les points de terminaison de l’arc. L’ellipse est définie par le rectangle englobant décrit par les xparamètres , y, widthet height . La forme de secteurs se compose des deux lignes radiales définies par les startAngle paramètres et sweepAngle et de l’arc entre les intersections de ces lignes radiales avec l’ellipse.

Si le sweepAngle paramètre est supérieur à 360 degrés ou inférieur à -360 degrés, il est traité comme s’il était à 360 degrés ou -360 degrés, respectivement.

DrawPie(Pen, RectangleF, Single, Single)

Source:

Graphics.cs

Dessine un secteur défini par une ellipse spécifiée par une structure RectangleF et deux lignes radiales.

public:
 void DrawPie(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect, float startAngle, float sweepAngle);

public void DrawPie (System.Drawing.Pen pen, System.Drawing.RectangleF rect, float startAngle, float sweepAngle);

member this.DrawPie : System.Drawing.Pen * System.Drawing.RectangleF * single * single -> unit

Public Sub DrawPie (pen As Pen, rect As RectangleF, startAngle As Single, sweepAngle As Single)

Paramètres

pen

Pen

Pen qui détermine la couleur, la largeur et le style du secteur.

rect

RectangleF

Structure RectangleF qui représente le rectangle englobant qui définit l'ellipse d'où est issu le secteur.

startAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir de l'axe x jusqu'au premier coté du secteur.

sweepAngle

Single

Angle, mesuré en degrés dans le sens des aiguilles d'une montre, à partir du paramètre startAngle jusqu'au deuxième coté du secteur.

Exceptions

ArgumentNullException

pen a la valeur null.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée un stylet noir.

• Crée un rectangle qui limite une ellipse complète.

• Définit les angles auxquels commencer le dessin (par rapport à l’axe X) et à travers lesquels dessiner (les deux dans le sens des aiguilles d’une montre).

• Dessine le segment en secteurs vers l’écran.

public:
   void DrawPieRectangleF( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle for ellipse.
      RectangleF rect = RectangleF(0.0F,0.0F,200.0F,100.0F);

      // Create start and sweep angles.
      float startAngle = 0.0F;
      float sweepAngle = 45.0F;

      // Draw pie to screen.
      e->Graphics->DrawPie( blackPen, rect, startAngle, sweepAngle );
   }

public void DrawPieRectangleF(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle for ellipse.
    RectangleF rect = new RectangleF(0.0F, 0.0F, 200.0F, 100.0F);
             
    // Create start and sweep angles.
    float startAngle =  0.0F;
    float sweepAngle = 45.0F;
             
    // Draw pie to screen.
    e.Graphics.DrawPie(blackPen, rect, startAngle, sweepAngle);
}

Public Sub DrawPieRectangleF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle for ellipse.
    Dim rect As New RectangleF(0.0F, 0.0F, 200.0F, 100.0F)

    ' Create start and sweep angles.
    Dim startAngle As Single = 0.0F
    Dim sweepAngle As Single = 45.0F

    ' Draw pie to screen.
    e.Graphics.DrawPie(blackPen, rect, startAngle, sweepAngle)
End Sub

Remarques

Cette méthode dessine une forme en secteurs définie par un arc d’une ellipse et les deux lignes radiales qui se croisent avec les points de terminaison de l’arc. L’ellipse est définie par le rectangle englobant. La forme de secteurs se compose des deux lignes radiales définies par les startAngle paramètres et sweepAngle et de l’arc entre les intersections de ces lignes radiales avec l’ellipse.

Si le sweepAngle paramètre est supérieur à 360 degrés ou inférieur à -360 degrés, il est traité comme s’il était à 360 degrés ou -360 degrés, respectivement.