| **Navigation:**  [[introduction.htm|Language Reference]] > 8 - Controls > Control Declarations >====== LINE (declare a line control) ====== | [[item  declare a menu item .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[list  declare a window list control .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

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

{{blk2blue.jpg|blk2blue.jpg}}

| **LINE** | Places a straight line 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** | A field equate label to reference the control in executable code (PROP:USE). |
| **DISABLE** | Specifies the control appears dimmed when the WINDOW or APPLICATION opens (PROP:DISABLE). |
| **COLOR** | Specifies the color for the line (PROP:COLOR). If omitted, the color is black. |
| **FULL** | Specifies the control expands to occupy the entire size of the WINDOW or REPORT band for any missing AT attribute width or height parameter (PROP:FULL). |
| **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. |
| **LINEWIDTH** | Specifies the thickness of the LINE (PROP:LINEWIDTH). |
| **LAYOUT** | Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT) |
| **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 **LINE** control places a straight line 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 //x// and //y// parameters of the AT attribute specify the starting point of the line. The //width// and //height// parameters of the AT attribute specify the horizontal and vertical distance to the end point of the line. If these are both positive numbers, the line slopes to the right and down from its starting point. If the //width// is negative, the line slopes left; if the //height// is negative, the line slopes left. If either the //width// or //height// is zero, the line is horizontal or vertical. This control cannot receive input focus and does not generate events.

** **__**Width**__**     **__**Height**__**   **__**Result**__

** positive   positive  right and down from start point**

** negative   positive  left and down from start point**

** positive   negative  right and up from start point**

** negative   negative  left and up from start point**

** zero       positive  vertical, down from start point**

** zero       negative  vertical, up from start point**

** positive   zero      horizontal, right from start point**

** negative   zero      horizontal, left from start point**

**Example:**

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

**          LINE,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER)   !Border color**

**          LINE,AT(480,180,20,20),SCROLL                    !Scrolls with screen**

**         END**

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

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

**            LINE,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER) !Border color**

**            LINE,AT(480,180,20,20),USE(?L2)**

**           END**

**          END**