BoxesUp

 

Displays WinBatch boxes.

Syntax:

BoxesUp(coordinates, show mode)

Parameters:

(s) coordinates window coordinates for placement of top-level WinBatch box, in virtual units (upper-x upper-y lower-x lower-y).

(i) show mode @NORMAL, @ICON, @ZOOMED, or @HIDDEN.

Returns:

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

 

Places a WinBatch box on the screen for which drawing tools can be defined. "Coordinates" specify the placement on the screen when the window is not zoomed (maximized). The "box ID" of this main box (window) is 1. Up to 7 more boxes (windows) may be defined with the BoxNew function.

Drawing tool definitions and drawing commands refer to a particular "box ID". Different drawing tools can be defined for separate boxes.

1000x1000 virtual screen size is based on the primary monitor in a multi-monitor display configuration.

Example:

;; sample script for BoxesUp
Message("WinBatch BoxesUp Example","BoxesUp can display a box in Normal Mode. ")
BoxesUp("200,200,800,800", @NORMAL)
BoxDrawText(1, "500,200,500,200", "WinBatch Box Example - BoxesUp %@crlf%Normal Mode", @FALSE, 1)
BoxCaption(1, "WinBatch BoxesUp Example - Normal Mode")
Message("WinBatch BoxesUp Example", "BoxesUp can display the box as an Icon.")
BoxDestroy(1)
BoxesUp("200,200,800,800", @ICON)
BoxDrawText(1, "500,200,500,200", "WinBatch Box Example - BoxesUp %@crlf% Icon Mode", @FALSE, 1)
BoxCaption(1, "WinBatch BoxesUp Example - Icon Mode")
Message("WinBatch BoxesUp Example", "BoxesUp can display in a Zoomed mode.")
BoxDestroy(1)
BoxesUp("200,200,800,800", @ZOOMED)
BoxDrawText(1, "500,200,500,200", "WinBatch Box Example - BoxesUp %@crlf%Zoomed Mode", @FALSE, 1)
BoxCaption(1, "WinBatch BoxesUp Example - Zoomed Mode")
Message("WinBatch BoxesUp Example", "In addition, WinBatch can set a hidden mode to the box.")

See Also:

BoxNew