User Tools

Site Tools


box_declare_a_box_control_.htm
Navigation:  Language Reference > 8 - Controls > Control Declarations >====== BOX (declare a box control) ====== Previous pageReturn to chapter overviewNext page
BOX ,AT( ) [,USE( )] [,DISABLE] [,COLOR( )] [,FILL( )] [,ROUND] [,FULL] [,SCROLL] [,HIDE]
[,LINEWIDTH( )] [,LAYOUT( )] [,EXTEND( )]

blk2blue.jpg

BOX Places a rectangular box on the window 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) is first opened (PROP:DISABLE).
COLOR Specifies the color for the border of the control (PROP:COLOR). If omitted, there is no border.
FILL Specifies the fill color for the control (PROP:FILL). If omitted, the box is not filled with color.
ROUND Specifies the box corners are rounded (PROP:ROUND). If omitted, the corners are square.
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. UNHIDE must be used to display it (PROP:HIDE). In a REPORT, specifies the control does not print unless UNHIDE is used to allow it to print
LINEWIDTH Specifies the width of the BOX's border (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 BOX control places a rectangular box on the WINDOW, TOOLBAR, or REPORT at the position and size specified by its AT attribute. This control cannot receive input focus and does not generate events. It is valid in Clarion Win32 Windows, and also for REPORT structures in both Clarion Win32 and Clarion#.

Example:

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

         !Unfilled, black border:

         BOX,AT(0,0,20,20)

         !Unfilled, black border, dimmed:

         BOX,AT(0,20,20,20),USE(?Box1),DISABLE

         !Unfilled, rounded, black border:

         BOX,AT(20,20,20,20),ROUND

         !Filled, black border:

         BOX,AT(40,40,20,20),FILL(COLOR:ACTIVEBORDER)

         !Unfilled, active border color border:

         BOX,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER)

         !Scrolls with screen:

         BOX,AT(480,180,20,20),SCROLL

        END

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

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

           BOX,AT(0,0,20,20),USE(?B1)                    !Unfilled, black border

           BOX,AT(20,20,20,20),ROUND                     !Unfilled, rounded, black border

           BOX,AT(40,40,20,20),FILL(COLOR:ACTIVEBORDER)  !Filled, black border

           BOX,AT(60,60,20,20),COLOR(COLOR:ACTIVEBORDER) !Unfilled, active border color border

          END

        END

See Also:

PANEL

box_declare_a_box_control_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)