Graphics.DrawPie 方法

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v6.0.0

套件:: System.Drawing.Common v7.0.0

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

套件:: System.Drawing.Common v9.0.0-preview.2.24128.3

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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

來源:: 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

備註

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

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

適用於

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

來源:: Graphics.cs

來源:: 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

周框左上角的 X 座標，這個周框定義派形的來源橢圓形。

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

備註

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

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

適用於

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

來源:: Graphics.cs

來源:: 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

周框左上角的 X 座標，這個周框定義派形的來源橢圓形。

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

來源:: 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)

參數

例外狀況

範例

備註

適用於

意見反應

其他資源