'FRAME' Define/Draw a Frame

GUI Display

Format

'FRAME'(x,y,x,y,style[,title$ [,textColor$[,frameHilightColor$[,frameShadowColor$]]]])

Where:

x,y	Placement coordinates, top left and bottom right, in graphical units. Numeric 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').
title$	Frame title. Optional. String expression.
textColor$	Color of the header text. Optional. (Default: Black)
frameHilightColor$	Color of highlight line. Optional. (Default: Light Gray)
frameShadowColor$	Color of shadow line. Optional. (Default: Dark Gray)

(The textColor$, frameHilightColor$ and frameShadowColor$ arguments were added in PxPlus 2024.)

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.

Frame Color

To define the color of the frame, use either of the following:

•  Set the FrameDarkClr and FrameLiteClr properties using the 'OPTION' mnemonic

     •  Specify the frameHilightColor$ and frameShadowColor$ arguments

Frame Text Color

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

•  Any foreground color mnemonic, such as 'RED', 'BLUE', 'CYAN', etc. (See Example)

•  Any background color mnemonic, such as '_RED', '_BLUE', '_CYAN', etc.

•  'COLOUR' (or 'COLOR') mnemonic for defining the foreground color

•  '_COLOUR' (or '_COLOR') mnemonic for defining the background color

•  Specify the textColor$ argument

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 property using either the 'OPTION' mnemonic or the SETDEV directive:

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

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

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")
print 'frame'(100,100,300,300,0,"Details","red","green","green")