Graphics.DrawEllipse 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

繪製由一對座標、高度和寬度所指定的週框定義的橢圓形。

多載

DrawEllipse(Pen, Int32, Int32, Int32, Int32)	繪製由矩形左上角、高度和寬度的座標指定之週框所定義的橢圓形。
DrawEllipse(Pen, Single, Single, Single, Single)	繪製由一對座標、高度和寬度所指定的週框定義的橢圓形。
DrawEllipse(Pen, RectangleF)	繪製由界限 RectangleF 定義的橢圓形。
DrawEllipse(Pen, Rectangle)	繪製由界限 Rectangle 結構指定的橢圓形。

DrawEllipse(Pen, Int32, Int32, Int32, Int32)

來源:

Graphics.cs

繪製由矩形左上角、高度和寬度的座標指定之週框所定義的橢圓形。

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

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

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

Public Sub DrawEllipse (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)

參數

pen

Pen

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

x

Int32

週框左上角的 X 軸座標，這個週框定義橢圓形。

y

Int32

週框左上角的 Y 軸座標，這個週框定義橢圓形。

width

Int32

週框的寬度，這個週框定義橢圓形。

height

Int32

週框的高度，這個週框定義橢圓形。

例外狀況

ArgumentNullException

pen 為 null。

範例

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

• 建立黑色畫筆。

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

• 將省略號繪製到畫面。

private:
   void DrawEllipseInt( 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;

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, x, y, width, height );
   }

private void DrawEllipseInt(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;
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height);
}

Private Sub DrawEllipseInt(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

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height)
End Sub

備註

這個方法會繪製由 、y、 width和 height 參數所描述x的周框所定義的橢圓形。

DrawEllipse(Pen, Single, Single, Single, Single)

來源:

Graphics.cs

繪製由一對座標、高度和寬度所指定的週框定義的橢圓形。

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

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

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

Public Sub DrawEllipse (pen As Pen, x As Single, y As Single, width As Single, height As Single)

參數

pen

Pen

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

x

Single

週框左上角的 X 軸座標，這個週框定義橢圓形。

y

Single

週框左上角的 Y 軸座標，這個週框定義橢圓形。

width

Single

週框的寬度，這個週框定義橢圓形。

height

Single

週框的高度，這個週框定義橢圓形。

例外狀況

ArgumentNullException

pen 為 null。

範例

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

• 建立黑色畫筆。

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

• 將省略號繪製到畫面。

private:
   void DrawEllipseFloat( 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;

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, x, y, width, height );
   }

private void DrawEllipseFloat(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;
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height);
}

Private Sub DrawEllipseFloat(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

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height)
End Sub

備註

這個方法會繪製由 、y、 width和 height 參數所描述x的周框所定義的橢圓形。

DrawEllipse(Pen, RectangleF)

來源:

Graphics.cs

繪製由界限 RectangleF 定義的橢圓形。

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);

public void DrawEllipse (System.Drawing.Pen pen, System.Drawing.RectangleF rect);

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

Public Sub DrawEllipse (pen As Pen, rect As RectangleF)

參數

pen

Pen

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

rect

RectangleF

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

例外狀況

ArgumentNullException

pen 為 null。

範例

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

• 建立黑色畫筆。

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

• 將省略號繪製到畫面。

private:
   void DrawEllipseRectangleF( 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);

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, rect );
   }

private void DrawEllipseRectangleF(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);
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect);
}

Private Sub DrawEllipseRectangleF(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)

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect)
End Sub

備註

這個方法會繪製由 參數所指定的周框所 rect 定義的橢圓形。

DrawEllipse(Pen, Rectangle)

來源:

Graphics.cs

繪製由界限 Rectangle 結構指定的橢圓形。

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);

public void DrawEllipse (System.Drawing.Pen pen, System.Drawing.Rectangle rect);

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

Public Sub DrawEllipse (pen As Pen, rect As Rectangle)

參數

pen

Pen

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

rect

Rectangle

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

例外狀況

ArgumentNullException

pen 為 null。

範例

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

• 建立黑色畫筆。

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

• 將省略號繪製到畫面。

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

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

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, rect );
   }

private void DrawEllipseRectangle(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle for ellipse.
    Rectangle rect = new Rectangle(0, 0, 200, 100);
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect);
}

Private Sub DrawEllipseRectangle(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)

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect)
End Sub

備註

這個方法會繪製由 參數所指定的周框所 rect 定義的橢圓形。