BoxPen

 

Sets the pen for a WinBatch box.

Syntax:

BoxPen(box ID, color, width)

Parameters:

(i) box ID the ID number of the desired WinBatch box.

(s) color color of pen to use.

(i) width width of pen to use, in virtual units.

Returns:

(i) @TRUE on success; @FALSE on failure.

 

Defines the color and width of a "pen". Pens are used to draw lines and borders of rectangles and ellipses. The default is black, 1 pixel wide.

Width is defined according to the current mapping mode, (see BoxMapMode). In the default mapping mode, a width of 10 is 1% of whichever is smaller, the width or the height of the box.

"Color" is a string in the form: "red, green, blue".

 

BLACK="0,0,0"

WHITE="255,255,255"

RED="255,0,0"

GREEN="0,255,0"

DKGRAY="128,128,128"

GRAY="192,192,192"

DKRED="128,0,0"

DKGREEN="0,128,0"

BLUE="0,0,255"

PURPLE="255,0,255"

YELLOW="255,255,0"

CYAN="0,255,255"

DKBLUE="0,0,128"

DKPURPLE="128,0,128"

DKYELLOW="128,128,0"

DKCYAN='0,128,128"

 

Example:

;; sample script for BoxPen
BoxesUp("100,100,900,900", @NORMAL)
BoxColor(1,"255,255,0",0)
BoxDrawRect( 1, "0,0,1000,1000", 2)
BoxDrawText(1, "0,200,1000,1000", "WinBatch Box Example - BoxPen ", @FALSE, 1)
BoxCaption(1, "WinBatch BoxPen Example")
BoxColor(1,"0,0,255", 0)
BoxPen(1,"255,0,0",25)
BoxDrawRect(1,"350,350,650,650", 1)
BoxDrawLine(1, "350,700,800,700")
TimeDelay(5)
See Also:

BoxesUp, BoxNew, BoxColor, BoxTextColor