BOX
A BOX control displays a filled rectangle (ie, a rectangular area filled in with one color).
![]() |
A BOX control with the GRAY and BORDER styles. |
Uses
Can be used to decorate or group other items.
Styles
A BOX must be created with one of the following 3 styles:
Black | The box is drawn with the same color as window frames. The default is black. |
Gray | The box is drawn with the same color as the screen background (desktop). The default is gray. |
White | The box is drawn with the same color as the window background. The default is white. |
A BOX also have any, all, or none of the following styles:
Notify | Causes the Window Layout's DBLCLK or CLICK subroutines for this control to be called when the mouse is double-clicked or clicked within the box (but not on some control inside of it). |
Sunken | Makes a sunken border. |
No Sibling | (NOSIBLING) Prevents this control from drawing into any overlapping controls. |
Group | Marks this control as the first of a group of controls in which the user can move from one control to the next with the arrow keys. All subsequent controls (after this first control) belong to the same group up to the next control that has its GROUP flag set. (ie, One group ends where the next begins). |
Disabled | Control is initially disabled. You can later enable it with a call to GuiSetCtlPlacement. |
Hide | Control is hidden. You can later make it visible with a call to GuiSetCtlPlacement. |
Border | Has a border. |
Extra styles
A BOX can have the following extra styles:
Modal Frame | (MODALFRAME) Has a double border. |
Static Edge | (STATICEDGE) Has a three-dimensional border intended to be used for windows that do not accept user input. |
Client Edge | (CLIENTEDGE) Has a 3D look comprised of a border with a sunken edge. |
Accept files | (FILES) Accepts drag-and-drop files (ie, the DROPFILES event). |
Transparent | The control is to be transparent. Any controls that are beneath this one are not obscured. |
Events
A BOX generates the following events:
Event name When it occurs CLICK The user has clicked inside the box. Note: A disabled box does not cause a CLICK event. This event also does not occur if the NOTIFY style is not specified for the control. DBLCLK The user has double-clicked inside the box. Note: A disabled box does not cause a DBLCLK event. This event also does not occur if the NOTIFY style is not specified for the control.
REXX Variable
A BOX must have a REXX variable associated with it only if you specify the NOTIFY style, or you wish to be able to change its state (with GuiSetCtlPlacement). You do not need to initialize the variable before opening the window which contains the BOX control.