GraphicsPath.AddArc 方法

定義

命名空間:

System.Drawing.Drawing2D

組件:

System.Drawing.Common.dll

將橢圓形弧線附加至目前的圖形。

多載

AddArc(Single, Single, Single, Single, Single, Single)	將橢圓形弧線附加至目前的圖形。
AddArc(Int32, Int32, Int32, Int32, Single, Single)	將橢圓形弧線附加至目前的圖形。
AddArc(Rectangle, Single, Single)	將橢圓形弧線附加至目前的圖形。
AddArc(RectangleF, Single, Single)	將橢圓形弧線附加至目前的圖形。

AddArc(Single, Single, Single, Single, Single, Single)

將橢圓形弧線附加至目前的圖形。

public:
 void AddArc(float x, float y, float width, float height, float startAngle, float sweepAngle);

public void AddArc (float x, float y, float width, float height, float startAngle, float sweepAngle);

member this.AddArc : single * single * single * single * single * single -> unit

Public Sub AddArc (x As Single, y As Single, width As Single, height As Single, startAngle As Single, sweepAngle As Single)

參數

x

Single

矩形區域左上角的 X 座標，定義繪製弧線的橢圓形。

y

Single

矩形區域左上角的 Y 座標，定義繪製弧線的橢圓形。

width

Single

矩形區域的寬度，定義繪製弧線的橢圓形。

height

Single

矩形區域的高度，定義繪製弧線的橢圓形。

startAngle

Single

弧線的起始角度，從 X 軸順時針測量以度為單位。

sweepAngle

Single

startAngle 與弧線結尾之間的角度。

範例

如需範例，請參閱 AddArc(Rectangle, Single, Single)。

備註

如果圖中有上一條線條或曲線，則會新增一條線，以將上一段的端點連接到弧線的開頭。

弧線會沿著指定的矩形所系結的橢圓形周長進行追蹤。 弧線的起點取決於從橢圓形的 X 軸（以 0 度角度為單位）的順時針測量開始角度的度數。 藉由以掃掠角度的度數從起點順時針測量，端點的位置也類似。 如果掃掠角度大於 360 度或小於 -360 度，則弧線會分別被 360 度或 -360 度橫掃。

AddArc(Int32, Int32, Int32, Int32, Single, Single)

將橢圓形弧線附加至目前的圖形。

public:
 void AddArc(int x, int y, int width, int height, float startAngle, float sweepAngle);

public void AddArc (int x, int y, int width, int height, float startAngle, float sweepAngle);

member this.AddArc : int * int * int * int * single * single -> unit

Public Sub AddArc (x As Integer, y As Integer, width As Integer, height As Integer, startAngle As Single, sweepAngle As Single)

參數

x

Int32

矩形區域左上角的 X 座標，定義繪製弧線的橢圓形。

y

Int32

矩形區域左上角的 Y 座標，定義繪製弧線的橢圓形。

width

Int32

矩形區域的寬度，定義繪製弧線的橢圓形。

height

Int32

矩形區域的高度，定義繪製弧線的橢圓形。

startAngle

Single

弧線的起始角度，從 X 軸順時針測量以度為單位。

sweepAngle

Single

startAngle 與弧線結尾之間的角度。

範例

如需範例，請參閱 AddArc(Rectangle, Single, Single)。

備註

如果圖中有上一條線條或曲線，則會新增一條線，以將上一段的端點連接到弧線的開頭。

弧線會沿著指定的矩形所系結的橢圓形周長進行追蹤。 弧線的起點取決於從橢圓形的 X 軸（以 0 度角度為單位）的順時針測量開始角度的度數。 藉由以掃掠角度的度數從起點順時針測量，端點的位置也類似。 如果掃掠角度大於 360 度或小於 -360 度，則弧線會分別被 360 度或 -360 度橫掃。

AddArc(Rectangle, Single, Single)

將橢圓形弧線附加至目前的圖形。

public:
 void AddArc(System::Drawing::Rectangle rect, float startAngle, float sweepAngle);

public void AddArc (System.Drawing.Rectangle rect, float startAngle, float sweepAngle);

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

Public Sub AddArc (rect As Rectangle, startAngle As Single, sweepAngle As Single)

參數

rect

Rectangle

Rectangle，表示從中擷取弧線之橢圓形的矩形界限。

startAngle

Single

弧線的起始角度，從 X 軸順時針測量以度為單位。

sweepAngle

Single

startAngle 與弧線結尾之間的角度。

範例

下列程式代碼範例的設計目的是要與 Windows Forms 搭配使用，而且需要 PaintEventArgseOnPaint 事件物件。 程式代碼會執行下列動作：

• 建立矩形，其中定義了弧線。

• 建立路徑，myPath。

• 定義從 0 度到 180 度掃掠的 180 度橢圓形弧線，並將其附加至路徑。

• 繪製畫面的路徑。

private:
   void AddArcExample( PaintEventArgs^ e )
   {
      // Create a GraphicsPath object.
      GraphicsPath^ myPath = gcnew GraphicsPath;

      // Set up and call AddArc, and close the figure.
      Rectangle rect = Rectangle(20,20,50,100);
      myPath->StartFigure();
      myPath->AddArc( rect, 0, 180 );
      myPath->CloseFigure();

      // Draw the path to screen.
      e->Graphics->DrawPath( gcnew Pen( Color::Red,3.0f ), myPath );
   }

private void AddArcExample(PaintEventArgs e)
{
             
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();
             
    // Set up and call AddArc, and close the figure.
    Rectangle rect = new Rectangle(20, 20, 50, 100);
    myPath.StartFigure();
    myPath.AddArc(rect, 0, 180);
    myPath.CloseFigure();
             
    // Draw the path to screen.
    e.Graphics.DrawPath(new Pen(Color.Red, 3), myPath);
}

Public Sub AddArcExample(ByVal e As PaintEventArgs)

    ' Create a GraphicsPath object.
    Dim myPath As New GraphicsPath

    ' Set up and call AddArc, and close the figure.
    Dim rect As New Rectangle(20, 20, 50, 100)
    myPath.StartFigure()
    myPath.AddArc(rect, 0, 180)
    myPath.CloseFigure()

    ' Draw the path to screen.
    e.Graphics.DrawPath(New Pen(Color.Red, 3), myPath)
End Sub

備註

如果圖中有上一條線條或曲線，則會新增一條線，以將上一段的端點連接到弧線的開頭。

弧線會沿著指定的矩形所系結的橢圓形周長進行追蹤。 弧線的起點取決於從橢圓形的 X 軸（以 0 度角度為單位）的順時針測量開始角度的度數。 藉由以掃掠角度的度數從起點順時針測量，端點的位置也類似。 如果掃掠角度大於 360 度或小於 -360 度，則弧線會分別被 360 度或 -360 度橫掃。

AddArc(RectangleF, Single, Single)

將橢圓形弧線附加至目前的圖形。

public:
 void AddArc(System::Drawing::RectangleF rect, float startAngle, float sweepAngle);

public void AddArc (System.Drawing.RectangleF rect, float startAngle, float sweepAngle);

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

Public Sub AddArc (rect As RectangleF, startAngle As Single, sweepAngle As Single)

參數

rect

RectangleF

RectangleF，表示從中擷取弧線之橢圓形的矩形界限。

startAngle

Single

弧線的起始角度，從 X 軸順時針測量以度為單位。

sweepAngle

Single

startAngle 與弧線結尾之間的角度。

範例

如需範例，請參閱 AddArc(Rectangle, Single, Single)。

備註

如果圖中有上一條線條或曲線，則會新增一條線，以將上一段的端點連接到弧線的開頭。

弧線會沿著指定的矩形所系結的橢圓形周長進行追蹤。 弧線的起點取決於從橢圓形的 X 軸（以 0 度角度為單位）的順時針測量開始角度的度數。 藉由以掃掠角度的度數從起點順時針測量，端點的位置也類似。 如果掃掠角度大於 360 度或小於 -360 度，則弧線會分別被 360 度或 -360 度橫掃。