LINE (declare a line control)

Top  Previous  Next

 

 

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