SPLITBOX Control
Creates a SPLITBOX Control within a Window
Description:
The SPLITBOX Control acts as a "container" for one or more other specific controls. It sets these controls out in the order they are defined within the container and provides a "gripper" next to each control allowing the user to change their size
A SPLITBOX Control can contain one or more BROWSE, COMBOBOX, EDITBOX, GRID, LISTBOX, TOOLBAR, and/or TREE Controls and/or SPLITCHILD Windows
The image below demonstrates a simple SPLITBOX acting as a container for two LISTBOX Controls. The "gripper" is the vertical dotted line between the two LISTBOX Controls
Syntax:
DEFINE SPLITBOX
PARENT <cParentWindowName>
BOTTOM <lValue>
HORIZONTAL <lValue>
Other Control / Window Definitions
END SPLITBOX
Valid For Use With:
This Control is assumed to be available for use with all Window types
Notes:
A SPLITBOX Control acts as a "container" for certain other Controls. These include BROWSE, COMBOBOX, EDITBOX, GRID, LISTBOX, TOOLBAR, TREE or SPLITCHILD Windows. If any other type of Control is defined, it is placed outside the SPLITBOX
The ROW and COL Properties for any Control that is included within a SPLITBOX should not be used when defining the control. Their placement within the SPLITBOX is managed internally by the program and their placement can be managed by users with the a gripper bar located on the Control's left side
A parent window that contains a SPLITBOX Control or a TOOLBAR Control cannot be virtually dimensioned. However, a TOOLBAR Control can be included within a virtually dimensioned SPLITCHILD Window
During testing it was found that if either the BOTTOM or HORIZONTAL Properties are used, any logicial value entered appears to be ignored with .T. being assumed
As a SPLITBOX Control acts as a container for other Controls they are referenced as "child" controls of the container. Eg. Win_Main.SPLITBOX.LstBox_1.VALUE
The original version of the help file for this item can be viewed here
Control Properties:
The following Properties are available to use when defining the SPLITBOX Control
Name | Data Type | Control | Description |
---|---|---|---|
PARENT | Character | D | Defines the Controls Parent Window |
HORIZONTAL | Logical | D | Defines if the SPLITBOX Control should be positioned horizontally or vertically on the Window |
BOTTOM | Logical | D | Defines if the SPLITBOX Control should be positioned at the bottom of the Window for a horizontally positioned SPLITBOX or on the right if the SPLITBOX has the HORIZONTAL Property |
D - Properties of this type can be used when defining a Window
R - Properties of this type can only be accessed (read) after the Window has been defined
W - Properties of this type can be changed (write) after the Window has been defined
See GETPROPERTY and SETPROPERTY functions for further infomation on accessing or changing properties or use semi-OOP syntax