Mnemonics

'FRAME'

Define/Draw a Frame

GUI Display 

Format

'FRAME'(x,y,x,y,style,[,title$])
 
Where: 

title$

Frame title. Optional. String expression.

style

Determines the style level and bevel sizes in creating the frame. Numeric expression:

 

>0 'FRAME' is elevated button with bevel width=style value.

 

<0 'FRAME' is inset with bevel width=style value.

 

=0 'FRAME' appears etched or flat (depends on '2D', '3D' or '4D').

x,y

Placement coordinates, top left and bottom right, in graphical units. Numeric expression.

Description

Use 'FRAME' to draw (print) a frame on the screen. Use graphical units or @X(col) / @Y(line) functions for beginning and ending the frame.

To define the color of the frame text, the frame text can be prefixed with any of the following mnemonics:

       Any foreground color mnemonic (e.g. 'RED', 'BLUE', 'CYAN')

       Any background color mnemonic (e.g. '_RED', '_BLUE', '_CYAN')

       A 'COLOUR' (or 'COLOR') mnemonic for defining foreground color

       A '_COLOUR' (or '_COLOR') mnemonic for defining background color

See the second example below.

(Support for defining frame text color was added in PxPlus 2021.)

Note:
If you are running PxPlus version 11 or higher and are using 4D mode to draw controls, the 'FRAME' text color can also be changed by setting the FrameTextClr option using either the 'OPTION' mnemonic or the SETDEV directive:

   SETDEV (0) SET "FrameTextClr" TO "xxx" (where xxx is the new value)

See Also

@X(col) and @Y(line) Convert X/Y Coordinates
'COLOUR' User-Defined Colours

Example

print 'frame'(100,100,450,450,10,"Hello There")
print 'frame'(100,100,500,200,10,'red'+"Frame Title")