Graphics.DrawArc 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

繪製弧形，表示由一對座標、寬度和高度所指定的橢圓形的一部分。

多載

DrawArc(Pen, Rectangle, Single, Single)	繪製弧形，表示由 Rectangle 結構所指定的橢圓形的一部分。
DrawArc(Pen, RectangleF, Single, Single)	繪製弧形，表示由 RectangleF 結構所指定的橢圓形的一部分。
DrawArc(Pen, Int32, Int32, Int32, Int32, Int32, Int32)	繪製弧形，表示由一對座標、寬度和高度所指定的橢圓形的一部分。
DrawArc(Pen, Single, Single, Single, Single, Single, Single)	繪製弧形，表示由一對座標、寬度和高度所指定的橢圓形的一部分。

DrawArc(Pen, Rectangle, Single, Single)

來源:

Graphics.cs

繪製弧形，表示由 Rectangle 結構所指定的橢圓形的一部分。

public:
 void DrawArc(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect, float startAngle, float sweepAngle);

public void DrawArc (System.Drawing.Pen pen, System.Drawing.Rectangle rect, float startAngle, float sweepAngle);

member this.DrawArc : System.Drawing.Pen * System.Drawing.Rectangle * single * single -> unit

Public Sub DrawArc (pen As Pen, rect As Rectangle, startAngle As Single, sweepAngle As Single)

參數

pen

Pen

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

rect

Rectangle

RectangleF 結構，定義橢圓形的邊界。

startAngle

Single

以度為單位，依順時針方向測量之從 X 軸到弧形開始點的角度。

sweepAngle

Single

以度為單位，依順時針方向測量之從 startAngle 參數到弧形結束點的角度。

例外狀況

ArgumentNullException

pen 為 null。

範例

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

• 建立黑色畫筆。

• 建立矩形以系結橢圓形。

• 定義開始 (45 度) 和掃掠 (270 度) 角度。

• 將橢圓形弧線繪製到螢幕。

結果是部分橢圓形遺漏了 x 軸的 + 和 - 45 度之間的線段。

private:
   void DrawArcRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle to bound ellipse.
      Rectangle rect = Rectangle(0,0,100,200);

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, rect, startAngle, sweepAngle );
   }

private void DrawArcRectangle(PaintEventArgs e)
{
   // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create rectangle to bound ellipse.
    Rectangle rect = new Rectangle(0, 0, 100, 200);
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle);
}

Private Sub DrawArcRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle to bound ellipse.
    Dim rect As New Rectangle(0, 0, 100, 200)

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle)
End Sub

備註

這個方法會繪製一個弧線，該弧線是橢圓形的一部分。 橢圓形是由矩形的界限所定義。 弧線是參數與startAngle + sweepAngle參數之間startAngle橢圓形的周邊部分。

DrawArc(Pen, RectangleF, Single, Single)

來源:

Graphics.cs

繪製弧形，表示由 RectangleF 結構所指定的橢圓形的一部分。

public:
 void DrawArc(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect, float startAngle, float sweepAngle);

public void DrawArc (System.Drawing.Pen pen, System.Drawing.RectangleF rect, float startAngle, float sweepAngle);

member this.DrawArc : System.Drawing.Pen * System.Drawing.RectangleF * single * single -> unit

Public Sub DrawArc (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。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立矩形以系結橢圓形。

• 定義開始 (45 度) 和掃掠 (270 度) 角度。

• 將橢圓形弧線繪製到螢幕。

結果是部分橢圓形遺漏了 x 軸的 + 和 - 45 度之間的線段。

private:
   void DrawArcRectangleF( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle to bound ellipse.
      RectangleF rect = RectangleF(0.0F,0.0F,100.0F,200.0F);

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, rect, startAngle, sweepAngle );
   }

private void DrawArcRectangleF(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create rectangle to bound ellipse.
    RectangleF rect = new RectangleF(0.0F, 0.0F, 100.0F, 200.0F);
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle);
}

Private Sub DrawArcRectangleF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle to bound ellipse.
    Dim rect As New RectangleF(0.0F, 0.0F, 100.0F, 200.0F)

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle)
End Sub

備註

這個方法會繪製一個弧線，該弧線是橢圓形的一部分。 橢圓形是由矩形的界限所定義。 弧線是參數與startAngle + sweepAngle參數之間startAngle橢圓形的周邊部分。

DrawArc(Pen, Int32, Int32, Int32, Int32, Int32, Int32)

來源:

Graphics.cs

繪製弧形，表示由一對座標、寬度和高度所指定的橢圓形的一部分。

public:
 void DrawArc(System::Drawing::Pen ^ pen, int x, int y, int width, int height, int startAngle, int sweepAngle);

public void DrawArc (System.Drawing.Pen pen, int x, int y, int width, int height, int startAngle, int sweepAngle);

member this.DrawArc : System.Drawing.Pen * int * int * int * int * int * int -> unit

Public Sub DrawArc (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。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立矩形的位置和大小，以系結橢圓形。

• 定義開始 (45 度) 和掃掠 (270 度) 角度。

• 將橢圓形弧線繪製到螢幕。

結果是部分橢圓形遺漏了 x 軸的 + 和 - 45 度之間的線段。

private:
   void DrawArcInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );
      // Create coordinates of rectangle to bound ellipse.
      int x = 0;
      int y = 0;
      int width = 100;
      int height = 200;

      // Create start and sweep angles on ellipse.
      int startAngle = 45;
      int sweepAngle = 270;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, x, y, width, height, startAngle, sweepAngle );
   }

private void DrawArcInt(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create coordinates of rectangle to bound ellipse.
    int x = 0;
    int y = 0;
    int width = 100;
    int height = 200;
             
    // Create start and sweep angles on ellipse.
    int startAngle =  45;
    int sweepAngle = 270;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, sweepAngle);
}

Private Sub DrawArcInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of rectangle to bound ellipse.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 100
    Dim height As Integer = 200

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Integer = 45
    Dim sweepAngle As Integer = 270

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, _
    sweepAngle)
End Sub

備註

這個方法會繪製一個弧線，該弧線是橢圓形的一部分。 橢圓形是由矩形的界限所定義。 弧線是參數與startAngle + sweepAngle參數之間startAngle橢圓形的周邊部分。

DrawArc(Pen, Single, Single, Single, Single, Single, Single)

來源:

Graphics.cs

繪製弧形，表示由一對座標、寬度和高度所指定的橢圓形的一部分。

public:
 void DrawArc(System::Drawing::Pen ^ pen, float x, float y, float width, float height, float startAngle, float sweepAngle);

public void DrawArc (System.Drawing.Pen pen, float x, float y, float width, float height, float startAngle, float sweepAngle);

member this.DrawArc : System.Drawing.Pen * single * single * single * single * single * single -> unit

Public Sub DrawArc (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。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立矩形的位置和大小，以系結橢圓形。

• 定義開始 (45 度) 和掃掠 (270 度) 角度。

• 將橢圓形弧線繪製到螢幕。

結果是部分橢圓形遺漏了 x 軸的 + 和 - 45 度之間的線段。

private:
   void DrawArcFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create coordinates of rectangle to bound ellipse.
      float x = 0.0F;
      float y = 0.0F;
      float width = 100.0F;
      float height = 200.0F;

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, x, y, width, height, startAngle, sweepAngle );
   }

private void DrawArcFloat(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create coordinates of rectangle to bound ellipse.
    float x = 0.0F;
    float y = 0.0F;
    float width = 100.0F;
    float height = 200.0F;
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, sweepAngle);
}

Private Sub DrawArcFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of rectangle to bound ellipse.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 100.0F
    Dim height As Single = 200.0F

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, _
    sweepAngle)
End Sub

備註

這個方法會繪製一個弧線，該弧線是橢圓形的一部分。 橢圓形是由矩形的界限所定義。 弧線是參數與startAngle + sweepAngle參數之間startAngle橢圓形的周邊部分。