| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== ELLIPSE (declare an ellipse control) ====== | [[combo  declare an entry list control .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[entry  declare a data entry control .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

| **ELLIPSE** ,**AT( )** | [,**USE( )**] [,**DISABLE**] [,**COLOR( )**] [,**FILL( )**] [,**FULL**] [,**SCROLL**] [,**HIDE**] [,**LAYOUT( )]** |
|  | [,**LINEWIDTH**] [,**EXTEND( )**] |

{{blk2blue.jpg|blk2blue.jpg}}

| **ELLIPSE** | Places a "circular" figure on the WINDOW, TOOLBAR, or REPORT. |
| **AT** | Specifies the initial size and location of the control (PROP:AT). If omitted, default values are selected by the runtime library. |
| **USE** | Specifies a field equate label to reference the control in executable code (PROP:USE). |
| **DISABLE** | Specifies the control appears dimmed when the WINDOW or APPLICATION is first opened (PROP:DISABLE). |
| **COLOR** | Specifies the color for the border of the ellipse (PROP:COLOR). If omitted, the ellipse has no border. |
| **FILL** | Specifies the fill color for the control (PROP:FILL). If omitted, the ellipse is not filled with color. |
| **FULL** | Specifies the control expands to occupy the entire size of the WINDOW for any missing AT attribute width or height parameter (PROP:FULL). Not valid in a REPORT. |
| **SCROLL** | Specifies the control scrolls with the window (PROP:SCROLL). Not valid in a REPORT. |
| **HIDE** | Specifies the control does not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display it. |
| **LAYOUT** | Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT) |
| **LINEWIDTH** | Specifies the width of the ELLIPSE's border (PROP:LINEWIDTH). |
| **EXTEND** | Specifies special document formatting information. This information contains a valid string of attributes that are assigned to a designated REPORT control for a given document type. Valid only in a REPORT. |

The **ELLIPSE** control places a "circular" figure on the WINDOW, TOOLBAR, or REPORT at the position and size specified by its AT attribute. It 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 of its AT attribute. 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." This control cannot receive input focus and does not generate events.

**Example:**

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

**          !Filled, full screen, black border:**

**          ELLIPSE,FILL(COLOR:MENU),FULL**

**          !Unfilled, black border:**

**          ELLIPSE,AT(0,0,20,20)**

**          !Dimmed:**

**          ELLIPSE,AT(0,20,20,20),USE(?Box1),DISABLE**

**          !Unfilled, rounded, black border:**

**          ELLIPSE,AT(20,20,20,20),ROUND**

**          !Filled, black border:**

**          ELLIPSE,AT(40,40,20,20),FILL(COLOR:ACTIVEBORDER)**

**          !Unfilled, active border color border:**

**          ELLIPSE,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER)**

**          !Scrolls with screen:**

**          ELLIPSE,AT(480,180,20,20),SCROLL**

**         END**

**CustRpt  REPORT,AT(1000,1000,6500,9000),THOUS**

**CustDetail DETAIL,AT(0,0,6500,1000)**

**            !Unfilled, black border:**

**            ELLIPSE,AT(0,0,20,20)**

**            !Unfilled, black border, dimmed:**

**            ELLIPSE,AT(0,20,20,20),USE(?Ellipse1),DISABLE**

**            !Unfilled, rounded, black border:**

**            ELLIPSE,AT(20,20,20,20),ROUND**

**            !Filled, black border:**

**            ELLIPSE,AT(40,40,20,20),FILL(COLOR:ACTIVEBORDER)**

**            !Unfilled, active border color border**

**            ELLIPSE,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER)**

**           END**

**         END**