Graphics.DrawPie Graphics.DrawPie Graphics.DrawPie Method

Определение

Рисует сектор, определяемый эллипсом, который задан парой координат, шириной, высотой и двумя радиальными линиями.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) DrawPie(Pen, Single, Single, Single, Single, Single, Single) 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) DrawPie(Pen, Rectangle, Single, Single) 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) DrawPie(Pen, RectangleF, Single, Single) 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) DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32) 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) DrawPie(Pen, Single, Single, Single, Single, Single, Single) 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

Параметры

pen
Pen Pen Pen

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

x
Single Single 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 Single 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 Single Single

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

height
Single Single Single

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

startAngle
Single Single Single

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

sweepAngle
Single Single Single

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

Исключения

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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

Комментарии

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется xограничивающим прямоугольником width, который описывается параметрами, y, и 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) DrawPie(Pen, Rectangle, Single, Single) 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

Параметры

pen
Pen Pen Pen

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

rect
Rectangle Rectangle Rectangle

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

startAngle
Single Single Single

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

sweepAngle
Single Single Single

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

Исключения

Свойство pen имеет значение null.pen is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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

Комментарии

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником.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) DrawPie(Pen, RectangleF, Single, Single) 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

Параметры

pen
Pen Pen Pen

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

rect
RectangleF RectangleF RectangleF

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

startAngle
Single Single Single

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

sweepAngle
Single Single Single

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

Исключения

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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

Комментарии

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется ограничивающим прямоугольником.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) DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32) 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

Параметры

pen
Pen Pen Pen

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

x
Int32 Int32 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 Int32 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 Int32 Int32

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

height
Int32 Int32 Int32

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

startAngle
Int32 Int32 Int32

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

sweepAngle
Int32 Int32 Int32

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

Исключения

Свойство pen имеет значение null.pen is null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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

Комментарии

Этот метод рисует круговую фигуру, определяемую дугой эллипса, и двумя радиальными линиями, пересекающимися с конечными точками дуги. Эллипс определяется xограничивающим прямоугольником width, который описывается параметрами, y, и 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.

Применяется к