Graphics.DrawPie Methode

Definition

Zeichnet eine durch eine Ellipse, die durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe und zwei Radien angegeben ist, definierte Kreisform.

Überlädt

DrawPie(Pen, Rectangle, Single, Single)

Zeichnet eine Kreisform, die von einer Ellipse definiert wird, die ihrerseits durch eine Rectangle-Struktur und zwei Radien angegeben ist.

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

Zeichnet eine durch eine Ellipse, die durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe und zwei Radien angegeben ist, definierte Kreisform.

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

Zeichnet eine durch eine Ellipse, die durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe und zwei Radien angegeben ist, definierte Kreisform.

DrawPie(Pen, RectangleF, Single, Single)

Zeichnet eine Kreisform, die von einer Ellipse definiert wird, die ihrerseits durch eine RectangleF-Struktur und zwei Radien angegeben ist.

DrawPie(Pen, Rectangle, Single, Single)

Zeichnet eine Kreisform, die von einer Ellipse definiert wird, die ihrerseits durch eine Rectangle-Struktur und zwei Radien angegeben ist.

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)

Parameter

pen
Pen

Pen, der die Farbe, die Breite und den Stil der Kreisform bestimmt.

rect
Rectangle

Rectangle-Struktur, die das umschließende Rechteck darstellt, das die Ellipse definiert, aus der die Kreisform stammt.

startAngle
Single

Zwischen der x-Achse und der ersten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

sweepAngle
Single

Zwischen dem startAngle-Parameter und der zweiten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

Ausnahmen

pen ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt einen schwarzen Stift.

  • Erstellt ein Rechteck, das eine vollständige Ellipse umschließt.

  • Definiert die Winkel, in denen das Zeichnen (relativ zur x-Achse) und durch die (beide im Uhrzeigersinn) gezeichnet werden soll.

  • Zeichnet das Kreissegment auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Kreisform, die durch einen Bogen einer Ellipse und die beiden radialen Linien definiert ist, die sich mit den Endpunkten des Bogens überschneiden. Die Ellipse wird durch das umgebende Rechteck definiert. Die Kreisform besteht aus den beiden radialen Linien, die durch die startAngle Parameter und sweepAngle definiert sind, und dem Bogen zwischen den Schnittpunkten dieser radialen Linien mit der Ellipse.

Wenn der sweepAngle Parameter größer als 360 Grad oder kleiner als -360 Grad ist, wird er behandelt, als wäre er 360 Grad bzw. -360 Grad.

Gilt für:

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

Zeichnet eine durch eine Ellipse, die durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe und zwei Radien angegeben ist, definierte Kreisform.

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)

Parameter

pen
Pen

Pen, der die Farbe, die Breite und den Stil der Kreisform bestimmt.

x
Int32

Die x-Koordinate der oberen linken Ecke des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

y
Int32

Die y-Koordinate der oberen linken Ecke des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

width
Int32

Breite des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

height
Int32

Höhe des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

startAngle
Int32

Zwischen der x-Achse und der ersten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

sweepAngle
Int32

Zwischen dem startAngle-Parameter und der zweiten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

Ausnahmen

pen ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt einen schwarzen Stift.

  • Erstellt die Position und Größe eines Rechtecks, das eine vollständige Ellipse umschließt.

  • Definiert die Winkel, in denen das Zeichnen (relativ zur x-Achse) und durch die (beide im Uhrzeigersinn) gezeichnet werden soll.

  • Zeichnet die Kreisform auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Kreisform, die durch einen Bogen einer Ellipse und die beiden radialen Linien definiert ist, die sich mit den Endpunkten des Bogens überschneiden. Die Ellipse wird durch das umgebende Rechteck definiert, das durch die xParameter , y, widthund height beschrieben wird. Die Kreisform besteht aus den beiden radialen Linien, die durch die startAngle Parameter und sweepAngle definiert sind, und dem Bogen zwischen den Schnittpunkten dieser radialen Linien mit der Ellipse.

Wenn der sweepAngle Parameter größer als 360 Grad oder kleiner als -360 Grad ist, wird er behandelt, als wäre er 360 Grad bzw. -360 Grad.

Gilt für:

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

Zeichnet eine durch eine Ellipse, die durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe und zwei Radien angegeben ist, definierte Kreisform.

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)

Parameter

pen
Pen

Pen, der die Farbe, die Breite und den Stil der Kreisform bestimmt.

x
Single

Die x-Koordinate der oberen linken Ecke des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

y
Single

Die y-Koordinate der oberen linken Ecke des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

width
Single

Breite des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

height
Single

Höhe des umschließenden Rechtecks, das die Ellipse definiert, aus der die Kreisform stammt.

startAngle
Single

Zwischen der x-Achse und der ersten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

sweepAngle
Single

Zwischen dem startAngle-Parameter und der zweiten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

Ausnahmen

pen ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt einen schwarzen Stift.

  • Erstellt die Position und Größe eines Rechtecks, das eine vollständige Ellipse umschließt.

  • Definiert die Winkel, in denen das Zeichnen (relativ zur x-Achse) und durch die (beide im Uhrzeigersinn) gezeichnet werden soll.

  • Zeichnet das Kreissegment auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Kreisform, die durch einen Bogen einer Ellipse und die beiden radialen Linien definiert ist, die sich mit den Endpunkten des Bogens überschneiden. Die Ellipse wird durch das umgebende Rechteck definiert, das durch die xParameter , y, widthund height beschrieben wird. Die Kreisform besteht aus den beiden radialen Linien, die durch die startAngle Parameter und sweepAngle definiert sind, und dem Bogen zwischen den Schnittpunkten dieser radialen Linien mit der Ellipse.

Wenn der sweepAngle Parameter größer als 360 Grad oder kleiner als -360 Grad ist, wird er behandelt, als wäre er 360 Grad bzw. -360 Grad.

Gilt für:

DrawPie(Pen, RectangleF, Single, Single)

Zeichnet eine Kreisform, die von einer Ellipse definiert wird, die ihrerseits durch eine RectangleF-Struktur und zwei Radien angegeben ist.

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)

Parameter

pen
Pen

Pen, der die Farbe, die Breite und den Stil der Kreisform bestimmt.

rect
RectangleF

RectangleF-Struktur, die das umschließende Rechteck darstellt, das die Ellipse definiert, aus der die Kreisform stammt.

startAngle
Single

Zwischen der x-Achse und der ersten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

sweepAngle
Single

Zwischen dem startAngle-Parameter und der zweiten Seite der Kreisform im Uhrzeigersinn gemessener Winkel in Grad.

Ausnahmen

pen ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

  • Erstellt einen schwarzen Stift.

  • Erstellt ein Rechteck, das eine vollständige Ellipse umschließt.

  • Definiert die Winkel, in denen das Zeichnen (relativ zur x-Achse) und durch die (beide im Uhrzeigersinn) gezeichnet werden soll.

  • Zeichnet das Kreissegment auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Kreisform, die durch einen Bogen einer Ellipse und die beiden radialen Linien definiert ist, die sich mit den Endpunkten des Bogens überschneiden. Die Ellipse wird durch das umgebende Rechteck definiert. Die Kreisform besteht aus den beiden radialen Linien, die durch die startAngle Parameter und sweepAngle definiert sind, und dem Bogen zwischen den Schnittpunkten dieser radialen Linien mit der Ellipse.

Wenn der sweepAngle Parameter größer als 360 Grad oder kleiner als -360 Grad ist, wird er behandelt, als wäre er 360 Grad bzw. -360 Grad.

Gilt für: