Graphics.DrawPie Methode

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v8.0.10

Paket:: System.Drawing.Common v9.0.0-rc.2.24474.1

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeichnet ein Kreis-Shape, das durch eine durch ein Koordinatenpaar angegebene Ellipse, eine Breite, eine Höhe und zwei Radiallinien definiert ist.

Überlädt

DrawPie(Pen, Rectangle, Single, Single)	Zeichnet eine Kreisform, die durch eine durch eine Rectangle Struktur und zwei Radiallinien angegebene Ellipse definiert ist.
DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32)	Zeichnet ein Kreis-Shape, das durch eine durch ein Koordinatenpaar angegebene Ellipse, eine Breite, eine Höhe und zwei Radiallinien definiert ist.
DrawPie(Pen, Single, Single, Single, Single, Single, Single)	Zeichnet ein Kreis-Shape, das durch eine durch ein Koordinatenpaar angegebene Ellipse, eine Breite, eine Höhe und zwei Radiallinien definiert ist.
DrawPie(Pen, RectangleF, Single, Single)	Zeichnet eine Kreisform, die durch eine durch eine RectangleF Struktur und zwei Radiallinien angegebene Ellipse definiert ist.

DrawPie(Pen, Rectangle, Single, Single)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Kreisform, die durch eine durch eine Rectangle Struktur und zwei Radiallinien angegebene Ellipse definiert 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, die die Farbe, Breite und Formatvorlage der Kreisform bestimmt.

rect: Rectangle

Rectangle Struktur, die das umgebende Rechteck darstellt, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

startAngle: Single

Winkel gemessen im Uhrzeigersinn von der X-Achse bis zur ersten Seite der Kreisform.

sweepAngle: Single

Winkel gemessen im Uhrzeigersinn vom startAngle-Parameter zur zweiten Seite der Kreisform.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

Erstellt einen schwarzen Stift.
Erstellt ein Rechteck, das eine vollständige Ellipse begrenzt.
Definiert die Winkel, in denen die Zeichnung beginnen soll (relativ zur x-Achse) und durch die (beide in richtung 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 definiert ist, und die beiden Radiallinien, die sich mit den Endpunkten des Bogens schneiden. Die Auslassungspunkte werden durch das umgebende Rechteck definiert. Die Kreisform besteht aus den beiden radialen Linien, die durch die parameter startAngle und sweepAngle definiert werden, und den Bogen zwischen den Schnittpunkten dieser Radiallinien mit den Auslassungspunkten.

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

Gilt für:

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

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein Kreis-Shape, das durch eine durch ein Koordinatenpaar angegebene Ellipse, eine Breite, eine Höhe und zwei Radiallinien definiert ist.

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, die die Farbe, Breite und Formatvorlage der Kreisform bestimmt.

x: Int32

Die x-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen das Kreis-Shape stammt.

y: Int32

Die Y-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen das Kreis-Shape stammt.

width: Int32

Breite des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

height: Int32

Höhe des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

startAngle: Int32

Winkel gemessen im Uhrzeigersinn von der X-Achse bis zur ersten Seite der Kreisform.

sweepAngle: Int32

Winkel gemessen im Uhrzeigersinn vom startAngle-Parameter zur zweiten Seite der Kreisform.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt die Position und Größe eines Rechtecks, das eine vollständige Ellipse begrenzt.
Definiert die Winkel, in denen die Zeichnung beginnen soll (relativ zur x-Achse) und durch die (beide in richtung uhrzeigersinn) gezeichnet werden soll.
Zeichnet das Kreis-Shape 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 definiert ist, und die beiden Radiallinien, die sich mit den Endpunkten des Bogens schneiden. Die Auslassungspunkte werden durch das umgebende Rechteck definiert, das durch die Parameter x, y, widthund height beschrieben wird. Die Kreisform besteht aus den beiden radialen Linien, die durch die parameter startAngle und sweepAngle definiert werden, und den Bogen zwischen den Schnittpunkten dieser Radiallinien mit den Auslassungspunkten.

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

Gilt für:

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

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein Kreis-Shape, das durch eine durch ein Koordinatenpaar angegebene Ellipse, eine Breite, eine Höhe und zwei Radiallinien definiert ist.

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, die die Farbe, Breite und Formatvorlage der Kreisform bestimmt.

x: Single

Die x-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen das Kreis-Shape stammt.

y: Single

Die Y-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen das Kreis-Shape stammt.

width: Single

Breite des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

height: Single

Höhe des umgebenden Rechtecks, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

startAngle: Single

Winkel gemessen im Uhrzeigersinn von der X-Achse bis zur ersten Seite der Kreisform.

sweepAngle: Single

Winkel gemessen im Uhrzeigersinn vom startAngle-Parameter zur zweiten Seite der Kreisform.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt die Position und Größe eines Rechtecks, das eine vollständige Ellipse begrenzt.
Definiert die Winkel, in denen die Zeichnung beginnen soll (relativ zur x-Achse) und durch die (beide in richtung 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 definiert ist, und die beiden Radiallinien, die sich mit den Endpunkten des Bogens schneiden. Die Auslassungspunkte werden durch das umgebende Rechteck definiert, das durch die Parameter x, y, widthund height beschrieben wird. Die Kreisform besteht aus den beiden radialen Linien, die durch die parameter startAngle und sweepAngle definiert werden, und den Bogen zwischen den Schnittpunkten dieser Radiallinien mit den Auslassungspunkten.

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

Gilt für:

DrawPie(Pen, RectangleF, Single, Single)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Kreisform, die durch eine durch eine RectangleF Struktur und zwei Radiallinien angegebene Ellipse definiert 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, die die Farbe, Breite und Formatvorlage der Kreisform bestimmt.

rect: RectangleF

RectangleF Struktur, die das umgebende Rechteck darstellt, das die Auslassungspunkte definiert, aus denen die Kreisform stammt.

startAngle: Single

Winkel gemessen im Uhrzeigersinn von der X-Achse bis zur ersten Seite der Kreisform.

sweepAngle: Single

Winkel gemessen im Uhrzeigersinn vom startAngle-Parameter zur zweiten Seite der Kreisform.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt ein Rechteck, das eine vollständige Ellipse begrenzt.
Definiert die Winkel, in denen die Zeichnung beginnen soll (relativ zur x-Achse) und durch die (beide in richtung 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

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

Gilt für:

Freigeben über

Graphics.DrawPie Methode

Definition

Überlädt

DrawPie(Pen, Rectangle, Single, Single)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

DrawPie(Pen, RectangleF, Single, Single)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen