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

 

SplitBox Control

 

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:

  1. 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

  2. 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

  3. 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

  4. 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

  5. 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

  6. 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

 

Sample Code:

 

Sample code to test this Property can be found here