Graphics.DrawArc 方法

參考

定義

命名空間:: 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 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

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

來源:: 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 度）角度。
將橢圓形弧線繪製到螢幕。

結果是部分省略號遺漏了 + 和 - 45 度 x 軸之間的線段。

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 參數與 startAngle + sweepAngle 參數之間橢圓形的周長部分。

適用於

DrawArc(Pen, RectangleF, Single, Single)

來源:: Graphics.cs

來源:: 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 度）角度。
將橢圓形弧線繪製到螢幕。

結果是部分省略號遺漏了 + 和 - 45 度 x 軸之間的線段。

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

備註

適用於

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

來源:: Graphics.cs

來源:: 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 度）角度。
將橢圓形弧線繪製到螢幕。

結果是部分省略號遺漏了 + 和 - 45 度 x 軸之間的線段。

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

備註

適用於

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

來源:: Graphics.cs

來源:: 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 度）角度。
將橢圓形弧線繪製到螢幕。

結果是部分省略號遺漏了 + 和 - 45 度 x 軸之間的線段。

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

備註

適用於

共用方式為

Graphics.DrawArc 方法

定義

多載

DrawArc(Pen, Rectangle, Single, Single)

參數

例外狀況

範例

備註

適用於

DrawArc(Pen, RectangleF, Single, Single)

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

範例

備註

適用於

其他資源