Graphics.DrawPie 方法

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v8.0.10

套件:: System.Drawing.Common v9.0.0-rc.2.24474.1

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

繪製由座標組、寬度、高度和兩條星形線所指定的橢圓形所定義的餅圖。

多載

DrawPie(Pen, Rectangle, Single, Single)	繪製由 Rectangle 結構和兩條星形線所指定的橢圓形所定義的餅圖。
DrawPie(Pen, Int32, Int32, Int32, Int32, Int32, Int32)	繪製由座標組、寬度、高度和兩條星形線所指定的橢圓形所定義的餅圖。
DrawPie(Pen, Single, Single, Single, Single, Single, Single)	繪製由座標組、寬度、高度和兩條星形線所指定的橢圓形所定義的餅圖。
DrawPie(Pen, RectangleF, Single, Single)	繪製由 RectangleF 結構和兩條星形線所指定的橢圓形所定義的餅圖。

DrawPie(Pen, Rectangle, Single, Single)

來源:: Graphics.cs

來源:: Graphics.cs

繪製由 Rectangle 結構和兩條星形線所指定的橢圓形所定義的餅圖。

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)

參數

pen: Pen

Pen，決定餅圖圖形的色彩、寬度和樣式。

rect: Rectangle

Rectangle 結構，代表定義餅圖來源橢圓形的周框。

startAngle: Single

從 X 軸到餅圖第一側的以度為單位測量的角度。

sweepAngle: Single

從 startAngle 參數到餅圖第二側以度為單位測量的角度。

例外狀況

ArgumentNullException

pen null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。程式代碼會執行下列動作：

建立黑色畫筆。
建立限定完整橢圓形的矩形。
定義開始繪製的角度（相對於 x 軸），以及繪製的角度（兩者都是以順時針方向繪製）。
將餅圖區段繪製到畫面。

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

備註

這個方法會繪製橢圓形弧線所定義的餅圖，以及與弧線端點交集的兩條星形線。橢圓形是由周框所定義。餅圖是由 startAngle 和 sweepAngle 參數所定義的兩條星形線所組成，以及這些星形線與橢圓形交集之間的弧線。

如果 sweepAngle 參數大於 360 度或小於 -360 度，則會將它視為 360 度或 -360 度。

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

繪製由座標組、寬度、高度和兩條星形線所指定的橢圓形所定義的餅圖。

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)

參數

pen: Pen

Pen，決定餅圖圖形的色彩、寬度和樣式。

x: Int32

周框左上角的 X 座標，定義餅圖的來源橢圓形。

y: Int32

周框左上角的 Y 座標，定義餅圖的橢圓形。

width: Int32

周框的寬度，定義餅圖的橢圓形。

height: Int32

周框的高度，定義餅圖的橢圓形。

startAngle: Int32

從 X 軸到餅圖第一側的以度為單位測量的角度。

sweepAngle: Int32

從 startAngle 參數到餅圖第二側以度為單位測量的角度。

例外狀況

ArgumentNullException

pen null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。程式代碼會執行下列動作：

建立黑色畫筆。
建立限定完整橢圓形之矩形的位置和大小。
定義開始繪製的角度（相對於 x 軸），以及繪製的角度（兩者都是以順時針方向繪製）。
將餅圖圖形繪製到畫面。

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、y、width和 height 參數所描述的周框所定義。餅圖是由 startAngle 和 sweepAngle 參數所定義的兩條星形線所組成，以及這些星形線與橢圓形交集之間的弧線。

如果 sweepAngle 參數大於 360 度或小於 -360 度，則會將它視為 360 度或 -360 度。

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

繪製由座標組、寬度、高度和兩條星形線所指定的橢圓形所定義的餅圖。

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)

參數

pen: Pen

Pen，決定餅圖圖形的色彩、寬度和樣式。

x: Single

周框左上角的 X 座標，定義餅圖的來源橢圓形。

y: Single

周框左上角的 Y 座標，定義餅圖的橢圓形。

width: Single

周框的寬度，定義餅圖的橢圓形。

height: Single

周框的高度，定義餅圖的橢圓形。

startAngle: Single

從 X 軸到餅圖第一側的以度為單位測量的角度。

sweepAngle: Single

從 startAngle 參數到餅圖第二側以度為單位測量的角度。

例外狀況

ArgumentNullException

pen null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。程式代碼會執行下列動作：

建立黑色畫筆。
建立限定完整橢圓形之矩形的位置和大小。
定義開始繪製的角度（相對於 x 軸），以及繪製的角度（兩者都是以順時針方向繪製）。
將餅圖區段繪製到畫面。

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

備註

如果 sweepAngle 參數大於 360 度或小於 -360 度，則會將它視為 360 度或 -360 度。

適用於

DrawPie(Pen, RectangleF, Single, Single)

來源:: Graphics.cs

來源:: Graphics.cs

繪製由 RectangleF 結構和兩條星形線所指定的橢圓形所定義的餅圖。

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)

參數

pen: Pen

Pen，決定餅圖圖形的色彩、寬度和樣式。

rect: RectangleF

RectangleF 結構，代表定義餅圖來源橢圓形的周框。

startAngle: Single

從 X 軸到餅圖第一側的以度為單位測量的角度。

sweepAngle: Single

從 startAngle 參數到餅圖第二側以度為單位測量的角度。

例外狀況

ArgumentNullException

pen null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。程式代碼會執行下列動作：

建立黑色畫筆。
建立限定完整橢圓形的矩形。
定義開始繪製的角度（相對於 x 軸），以及繪製的角度（兩者都是以順時針方向繪製）。
將餅圖區段繪製到畫面。

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

備註

如果 sweepAngle 參數大於 360 度或小於 -360 度，則會將它視為 360 度或 -360 度。

適用於

共用方式為

Graphics.DrawPie 方法

定義

多載

DrawPie(Pen, Rectangle, Single, Single)

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

範例

備註

適用於

DrawPie(Pen, RectangleF, Single, Single)

參數

例外狀況

範例

備註

適用於

其他資源