| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== ELLIPSE (draw an ellipse) ====== | [[duplicate  check for duplicate key entries .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[empty  empty a data file .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**ELLIPSE(**// x ,y ,width ,height// [,//fill//] [,//attributelist//]**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **ELLIPSE** | Draws an ellipse on the current window or report. |
| //X// | An integer expression that specifies the horizontal position of the starting point. |
| //Y// | An integer expression that specifies the vertical position of the starting point. |
| //Width// | An integer expression that specifies the width. |
| //Height// | An integer expression that specifies the height. |
| //Fill// | A LONG integer constant, constant EQUATE, or variable containing the red, green, and blue components that create the color in the three low-order bytes (bytes 0, 1, and 2) or an EQUATE for a standard Windows color value. |
| //attributelist// | A string constant, variable, or EQUATE containing an optional type of output document and its associated attributes. Only valid when the target is a REPORT. See [[comment set document formatting .htm|EXTEND]] |

The **ELLIPSE** procedure places an ellipse on the current window or report. This procedure is valid in Clarion Win32 Windows, and also for REPORT structures in both Clarion Win32 and Clarion#. The ellipse is drawn inside a "bounding box" defined by the //x//, //y//, //width//, and //height// parameters. The //x// and //y// parameters specify the starting point, and the //width// and //height// parameters specify the horizontal and vertical size of the "bounding box."

The border color is the current pen color set by SETPENCOLOR; the default color is the Windows system color for window text. The border width is the current width set by SETPENWIDTH; the default width is one pixel. The border style is the current pen style set by SETPENSTYLE; the default style is a solid line.

**Example:**

**MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL**

**          !window controls**

**         END**

** CODE**

** OPEN(MDIChild)**

** ****ELLIPSE****(100,50,100,50,00FF0000h)   !Red ellipse**

**See Also:**

[[current target.htm|Current Target]]

[[setpencolor  set line draw color .htm|SETPENCOLOR]]

[[setpenwidth  set line draw thickness .htm|SETPENWIDTH]]

[[setpenstyle  set line draw style .htm|SETPENSTYLE]]