| Navigation: Language Reference > 8 - Controls > Control Declarations >====== LINE (declare a line control) ====== |    |
| LINE ,AT( ) [,USE( )] [,DISABLE] [,COLOR( )] [,FULL] [,SCROLL] [,HIDE] [,LINEWIDTH( )][,LAYOUT()] [,EXTEND( )] |
| 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