Split Layout Manager (PRIM_SPLM)

Split Layout Manager

Ancestors - Base Layout Manager (PRIM_DTVW) Object (PRIM_OBJT)

Details

The Split Layout Manager is used to manage a component's display area such that the child components are split either horizontally or vertically.
 
The Orientation property defines the direction of the divisions.
 
By default, a divider will be shown between the managed controls allowing the allocation of space to be changed by the user.
 
The IDE will manage layout definition through the use of the designer. This code is provided for reference purposes.

Example

This example shows a simple form with vertical split. The panel to the left has a weight of 0 while the other has a weight of 1. The panel on the right will resize to occupy whatever space is available.
Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Clientwidth(660) Clientheight(338) Componentversion(2) Top(215) Left(237) Layoutmanager(#SplitLayout)
 
   Define_Com Class(#PRIM_VS.Style) Name(#Style1) Backgroundbrush(#Brush1)
   Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush1) Color(Theme500)
 
   Define_Com Class(#PRIM_SPLM) Name(#SplitLayout) Orientation(Vertical) Dividerstyle(Gap)
   Define_Com Class(#PRIM_SPLI) Name(#SplitLayoutItem1) Manage(#Panel1) Parent(#SplitLayout)
   Define_Com Class(#PRIM_SPLI) Name(#SplitLayoutItem2) Manage(#Panel2) Parent(#SplitLayout) Weight(1)
 
   Define_Com Class(#PRIM_PANL) Name(#Panel1) Displayposition(1) Height(338) Left(0) Parent(#COM_OWNER) Tabposition(1) Tabstop(False) Top(0) Width(331) Style(#Style1)
   Define_Com Class(#PRIM_PANL) Name(#Panel2) Displayposition(2) Height(338) Left(339) Parent(#COM_OWNER) Tabposition(2) Tabstop(False) Top(0) Width(321) Style(#Style1)
 
End_Com

Properties

NameDescription
ComponentClassNameComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT)
ComponentMembersComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT)
ComponentPatternNameComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT)
ComponentTagGeneric space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT)
ComponentTypeComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT)
ComponentTypeNameComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT)
DividerStyleAppearance of the divider
MaxHeightMaximum height of the control when the container is resized Inherited from Base Layout Manager (PRIM_DTVW)
MaxWidthMaximum width of the control when the container is resized Inherited from Base Layout Manager (PRIM_DTVW)
MinHeightMinimum height of the control when the container is resized Inherited from Base Layout Manager (PRIM_DTVW)
MinWidthMinimum width of the control when the container is resized Inherited from Base Layout Manager (PRIM_DTVW)
NameName identifies the component Inherited from Object (PRIM_OBJT)
OrientationDefines the orientation of the divider
OwnerOwner owns this component Inherited from Object (PRIM_OBJT)
ParentThe component instance to which this instance is attached. The visual container for a control or the collector of a set of child instances Inherited from Object (PRIM_OBJT)
SizingDetermines how the layout manager will behave within the composite control it manages Inherited from Base Layout Manager (PRIM_DTVW)

Events

NameDescription
CreateInstanceCreateInstance is signalled when an instance of a component is created Inherited from Base Layout Manager (PRIM_DTVW)
DestroyInstanceDestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Base Layout Manager (PRIM_DTVW)

See also

All Component Classes

Technical Reference

Febuary 18 V14SP2