Divider allowing columns to be resized at runtime
Ancestors - Table Vertical Division (PRIM_TBLO.VerticalDivision) Table Division (PRIM_TBLO.Division) Object (PRIM_OBJT)
A Divider Column allows columns to be resized at runtime by the user. Dividers follow the same rules as columns in terms of Width and Units, and are also counted when evaluating ColumnSpan. The StartRow and EndRow properties allow a divider to only work on a portion of the height of the container. This helps mitigate the need to spilt the UI in to different areas to avoid the divider spreading in to a different area. There is no practical limit to the number of dividers that a page can have. Divider style is governed by the Table Layout itself rather than the individual divider.
This example shows how multiple dividers can be used to quickly split an page in to different resizable areas. Note how the two column dividers both start on the second row so that they don't compromise the header area.
Begin_Com Role(*EXTENDS #PRIM_WEB) Height(537) Width(1169) Layoutmanager(#TableLayout1) Define_Com Class(#PRIM_VS.Style) Name(#Style1) Backgroundbrush(#Brush1) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush1) Color(Theme300) Define_Com Class(#PRIM_VS.Style) Name(#Style2) Backgroundbrush(#Brush2) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush2) Color(Theme500) Define_Com Class(#PRIM_VS.Style) Name(#Style3) Backgroundbrush(#Brush3) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush3) Color(Theme700) Define_Com Class(#PRIM_VS.Style) Name(#Style4) Backgroundbrush(#Brush4) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush4) Color(Theme600) Define_Com Class(#PRIM_VS.Style) Name(#Style5) Backgroundbrush(#Brush5) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush5) Color(Theme400) Define_Com Class(#PRIM_VS.Style) Name(#Style6) Backgroundbrush(#Brush6) Define_Com Class(#PRIM_VS.SolidBrush) Name(#Brush6) Color(Theme300) Define_Com Class(#PRIM_TBLO) Name(#TableLayout1) Dividerstyle(Gap) Define_Com Class(#PRIM_TBLO.Column) Name(#Column1) Displayposition(1) Parent(#TableLayout1) Units(Pixels) Width(140) Define_Com Class(#PRIM_TBLO.Column) Name(#Column2) Displayposition(3) Parent(#TableLayout1) Define_Com Class(#PRIM_TBLO.Column) Name(#Column3) Displayposition(5) Parent(#TableLayout1) Define_Com Class(#PRIM_TBLO.ColumnDivider) Name(#ColumnDivider2) Displayposition(2) Parent(#TableLayout1) Width(4) Startrow(#Row2) Define_Com Class(#PRIM_TBLO.RowDivider) Name(#RowDivider1) Displayposition(2) Height(4) Parent(#TableLayout1) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutItem1) Alignment(TopLeft) Column(#Column1) Flow(Down) Manage(#Label1) Parent(#TableLayout1) Row(#Row1) Columnspan(5) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutItem2) Alignment(TopLeft) Column(#Column1) Flow(Down) Manage(#Label2) Parent(#TableLayout1) Row(#Row2) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutItem3) Alignment(TopLeft) Column(#Column2) Flow(Down) Manage(#Label3) Parent(#TableLayout1) Row(#Row2) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutItem4) Alignment(TopLeft) Column(#Column3) Flow(Down) Manage(#Label4) Parent(#TableLayout1) Row(#Row2) Define_Com Class(#PRIM_TBLO.ColumnDivider) Name(#ColumnDivider1) Displayposition(4) Parent(#TableLayout1) Width(4) Startrow(#Row2) Define_Com Class(#PRIM_TBLO.Row) Name(#Row1) Displayposition(1) Parent(#TableLayout1) Height(140) Units(Pixels) Define_Com Class(#PRIM_TBLO.Row) Name(#Row2) Displayposition(3) Parent(#TableLayout1) Height(1.51) Define_Com Class(#PRIM_LABL) Name(#Label1) Caption('Heading') Displayposition(1) Ellipses(Word) Height(140) Left(0) Parent(#COM_OWNER) Tabposition(1) Tabstop(False) Top(0) Verticalalignment(Center) Width(1169) Alignment(Center) Style(#Style4) Define_Com Class(#PRIM_LABL) Name(#Label2) Caption('Left') Displayposition(2) Ellipses(Word) Height(393) Left(0) Parent(#COM_OWNER) Tabposition(2) Tabstop(False) Top(144) Verticalalignment(Center) Width(140) Style(#Style5) Alignment(Center) Define_Com Class(#PRIM_LABL) Name(#Label3) Displayposition(3) Ellipses(Word) Height(393) Left(144) Parent(#COM_OWNER) Tabposition(3) Tabstop(False) Top(144) Verticalalignment(Center) Width(511) Style(#Style6) Alignment(Center) Caption('Body Left') Define_Com Class(#PRIM_LABL) Name(#Label4) Caption('Body Right') Displayposition(4) Ellipses(Word) Height(393) Left(659) Parent(#COM_OWNER) Tabposition(4) Tabstop(False) Top(144) Verticalalignment(Center) Width(510) Style(#Style6) Alignment(Center) End_Com
Name | Description |
---|---|
ComponentClassName | ComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT) |
ComponentMembers | ComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT) |
ComponentPatternName | ComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT) |
ComponentTag | Generic space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT) |
ComponentType | ComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT) |
ComponentTypeName | ComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT) |
DisplayPosition | Relative position of the column |
EndRow | Specifies on which row the divider will stop being accessible |
Name | Name identifies the component Inherited from Object (PRIM_OBJT) |
Owner | Owner owns this component Inherited from Object (PRIM_OBJT) |
Parent | Reference to the table containing the divider |
StartRow | Specifies on which row the divider will become accessible |
Width | Width of the divider in pixels |
Name | Description |
---|---|
CreateInstance | CreateInstance is signalled when an instance of a component is created Inherited from Table Divider Column (PRIM_TBLO.ColumnDivider) |
DestroyInstance | DestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Table Divider Column (PRIM_TBLO.ColumnDivider) |
Febuary 18 V14SP2