Graphics.DrawPie Method

Definition

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a coordinate pair, a width, a height, and two radial lines.

Overloads

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

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a coordinate pair, a width, a height, and two radial lines.

DrawPie(Pen, Rectangle, Single, Single)

Рисует сектор, который определяется эллипсом, заданным структурой Rectangle и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a Rectangle structure and two radial lines.

DrawPie(Pen, RectangleF, Single, Single)

Рисует сектор, который определяется эллипсом, заданным структурой RectangleF и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a RectangleF structure and two radial lines.

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

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a coordinate pair, a width, a height, and two radial lines.

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

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a coordinate pair, a width, a height, and two radial lines.

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)

Parameters

pen
Pen

Объект Pen, определяющий цвет, ширину и стиль сектора.Pen that determines the color, width, and style of the pie shape.

x
Single

Координата X верхнего левого угла ограничивающего прямоугольника, определяющего эллипс, частью которого является сектор.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse from which the pie shape comes.

y
Single

Координата Y верхнего левого угла ограничивающего прямоугольника, определяющего эллипс, частью которого является сектор.The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse from which the pie shape comes.

width
Single

Ширина ограничивающего прямоугольника, определяющего эллипс, частью которого является данный сектор.Width of the bounding rectangle that defines the ellipse from which the pie shape comes.

height
Single

Высота ограничивающего прямоугольника, определяющего эллипс, частью которого является данный сектор.Height of the bounding rectangle that defines the ellipse from which the pie shape comes.

startAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от оси X и заканчивая первой стороной сектора.Angle measured in degrees clockwise from the x-axis to the first side of the pie shape.

sweepAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от значения параметра startAngle и заканчивая второй стороной сектора.Angle measured in degrees clockwise from the startAngle parameter to the second side of the pie shape.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает расположение и размер прямоугольника, ограничивающего законченный эллипс.Creates the position and size of a rectangle that bounds a complete ellipse.

  • Определяет углы, с которых начинается рисование (относительно оси x) и для рисования (и в направлении по часовой стрелке).Defines the angles at which to start drawing (relative to the x axis) and through which to draw (both in a clockwise direction).

  • Рисует сегмент круга на экране.Draws the pie segment to the screen.

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

Remarks

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником, который описывается параметрами x, y, widthи height.This method draws a pie shape defined by an arc of an ellipse and the two radial lines that intersect with the endpoints of the arc. The ellipse is defined by the bounding rectangle described by the x, y, width, and height parameters. Круговая фигура состоит из двух радиальных линий, определяемых startAngle и sweepAngle параметров, а также дуги между пересечениями этих радиальных линий с помощью эллипса.The pie shape consists of the two radial lines defined by the startAngle and sweepAngle parameters, and the arc between the intersections of those radial lines with the ellipse.

Если параметр sweepAngle больше 360 градусов или меньше-360 градусов, он обрабатывается так, как если бы он был равен 360 градусам или-360 градусам соответственно.If the sweepAngle parameter is greater than 360 degrees or less than -360 degrees, it is treated as if it were 360 degrees or -360 degrees, respectively.

DrawPie(Pen, Rectangle, Single, Single)

Рисует сектор, который определяется эллипсом, заданным структурой Rectangle и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a Rectangle structure and two radial lines.

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)

Parameters

pen
Pen

Объект Pen, определяющий цвет, ширину и стиль сектора.Pen that determines the color, width, and style of the pie shape.

rect
Rectangle

Структура Rectangle, представляющая ограничивающий прямоугольник, определяющий эллипс, частью которого является данный сектор.Rectangle structure that represents the bounding rectangle that defines the ellipse from which the pie shape comes.

startAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от оси X и заканчивая первой стороной сектора.Angle measured in degrees clockwise from the x-axis to the first side of the pie shape.

sweepAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от значения параметра startAngle и заканчивая второй стороной сектора.Angle measured in degrees clockwise from the startAngle parameter to the second side of the pie shape.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает прямоугольник, ограничивающий законченный эллипс.Creates a rectangle that bounds a complete ellipse.

  • Определяет углы, с которых начинается рисование (относительно оси x) и для рисования (и в направлении по часовой стрелке).Defines the angles at which to start drawing (relative to the x axis) and through which to draw (both in a clockwise direction).

  • Рисует сегмент круга на экране.Draws the pie segment to the screen.

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

Remarks

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником.This method draws a pie shape defined by an arc of an ellipse and the two radial lines that intersect with the endpoints of the arc. The ellipse is defined by the bounding rectangle. Круговая фигура состоит из двух радиальных линий, определяемых startAngle и sweepAngle параметров, а также дуги между пересечениями этих радиальных линий с помощью эллипса.The pie shape consists of the two radial lines defined by the startAngle and sweepAngle parameters, and the arc between the intersections of those radial lines with the ellipse.

Если параметр sweepAngle больше 360 градусов или меньше-360 градусов, он обрабатывается так, как если бы он был равен 360 градусам или-360 градусам соответственно.If the sweepAngle parameter is greater than 360 degrees or less than -360 degrees, it is treated as if it were 360 degrees or -360 degrees, respectively.

DrawPie(Pen, RectangleF, Single, Single)

Рисует сектор, который определяется эллипсом, заданным структурой RectangleF и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a RectangleF structure and two radial lines.

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)

Parameters

pen
Pen

Объект Pen, определяющий цвет, ширину и стиль сектора.Pen that determines the color, width, and style of the pie shape.

rect
RectangleF

Структура RectangleF, представляющая ограничивающий прямоугольник, определяющий эллипс, частью которого является данный сектор.RectangleF structure that represents the bounding rectangle that defines the ellipse from which the pie shape comes.

startAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от оси X и заканчивая первой стороной сектора.Angle measured in degrees clockwise from the x-axis to the first side of the pie shape.

sweepAngle
Single

Угол (в градусах), который измеряется по часовой стрелке, начиная от значения параметра startAngle и заканчивая второй стороной сектора.Angle measured in degrees clockwise from the startAngle parameter to the second side of the pie shape.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает прямоугольник, ограничивающий законченный эллипс.Creates a rectangle that bounds a complete ellipse.

  • Определяет углы, с которых начинается рисование (относительно оси x) и для рисования (и в направлении по часовой стрелке).Defines the angles at which to start drawing (relative to the x axis) and through which to draw (both in a clockwise direction).

  • Рисует сегмент круга на экране.Draws the pie segment to the screen.

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

Remarks

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником.This method draws a pie shape defined by an arc of an ellipse and the two radial lines that intersect with the endpoints of the arc. The ellipse is defined by the bounding rectangle. Круговая фигура состоит из двух радиальных линий, определяемых startAngle и sweepAngle параметров, а также дуги между пересечениями этих радиальных линий с помощью эллипса.The pie shape consists of the two radial lines defined by the startAngle and sweepAngle parameters, and the arc between the intersections of those radial lines with the ellipse.

Если параметр sweepAngle больше 360 градусов или меньше-360 градусов, он обрабатывается так, как если бы он был равен 360 градусам или-360 градусам соответственно.If the sweepAngle parameter is greater than 360 degrees or less than -360 degrees, it is treated as if it were 360 degrees or -360 degrees, respectively.

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

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.Draws a pie shape defined by an ellipse specified by a coordinate pair, a width, a height, and two radial lines.

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)

Parameters

pen
Pen

Объект Pen, определяющий цвет, ширину и стиль сектора.Pen that determines the color, width, and style of the pie shape.

x
Int32

Координата X верхнего левого угла ограничивающего прямоугольника, определяющего эллипс, частью которого является сектор.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse from which the pie shape comes.

y
Int32

Координата Y верхнего левого угла ограничивающего прямоугольника, определяющего эллипс, частью которого является сектор.The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse from which the pie shape comes.

width
Int32

Ширина ограничивающего прямоугольника, определяющего эллипс, частью которого является данный сектор.Width of the bounding rectangle that defines the ellipse from which the pie shape comes.

height
Int32

Высота ограничивающего прямоугольника, определяющего эллипс, частью которого является данный сектор.Height of the bounding rectangle that defines the ellipse from which the pie shape comes.

startAngle
Int32

Угол (в градусах), который измеряется по часовой стрелке, начиная от оси X и заканчивая первой стороной сектора.Angle measured in degrees clockwise from the x-axis to the first side of the pie shape.

sweepAngle
Int32

Угол (в градусах), который измеряется по часовой стрелке, начиная от значения параметра startAngle и заканчивая второй стороной сектора.Angle measured in degrees clockwise from the startAngle parameter to the second side of the pie shape.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает расположение и размер прямоугольника, ограничивающего законченный эллипс.Creates the position and size of a rectangle that bounds a complete ellipse.

  • Определяет углы, с которых начинается рисование (относительно оси x) и для рисования (и в направлении по часовой стрелке).Defines the angles at which to start drawing (relative to the x axis) and through which to draw (both in a clockwise direction).

  • Отображает круговую фигуру на экране.Draws the pie shape to the screen.

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

Remarks

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником, который описывается параметрами x, y, widthи height.This method draws a pie shape defined by an arc of an ellipse and the two radial lines that intersect with the endpoints of the arc. The ellipse is defined by the bounding rectangle described by the x, y, width, and height parameters. Круговая фигура состоит из двух радиальных линий, определяемых startAngle и sweepAngle параметров, а также дуги между пересечениями этих радиальных линий с помощью эллипса.The pie shape consists of the two radial lines defined by the startAngle and sweepAngle parameters, and the arc between the intersections of those radial lines with the ellipse.

Если параметр sweepAngle больше 360 градусов или меньше-360 градусов, он обрабатывается так, как если бы он был равен 360 градусам или-360 градусам соответственно.If the sweepAngle parameter is greater than 360 degrees or less than -360 degrees, it is treated as if it were 360 degrees or -360 degrees, respectively.

Applies to