| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== CHORD (draw a section of an ellipse) ====== | [[choose  return chosen value .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[chr  return character from ascii .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**CHORD(**// x ,y ,width ,height ,startangle ,endangle// [,//fill//] [,//attributelist//]**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **CHORD** | Draws a closed sector of 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. |
| //startangle// | An integer expression that specifies the starting point of the chord, in tenths of degrees (10 = 1 degree) measured counter-clockwise from three o'clock. |
| //endangle// | An integer expression that specifies the ending point of the chord, in tenths of degrees (10 = 1 degree) measured counter-clockwise from three o'clock. |
| //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 **CHORD** procedure places a closed sector of 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 //startangle// and //endangle// parameters specify what sector of the ellipse will be drawn, as an arc. The two end points of the arc are also connected with a straight line.

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)**

** ****CHORD****(100,50,100,50,0,900,00FF0000h)   !Red 90 degree crescent**

**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]]