This example shows the effect of the LAYOUT command's effect inside CHAPTER and GROUP statements, within a newly defined, user-specified definition.
RENAME DEFINITION "User 1" TO "My Definition" DEFINITION "My Definition" { LAYOUT { COLS 3 ALIGN OVER TAB } PROPERTY "My Property 1" { EDIT Text Length 10} PROPERTY "My Property 2" { EDIT Text Length 10} GROUP "No Layout Specified" { PROPERTY "My Property 3"{ EDIT Text Length 10} PROPERTY "My Property 4"{ EDIT Text Length 10} PROPERTY "My Property 5"{ EDIT Text Length 10} PROPERTY "My Property 6"{ EDIT Text Length 10} } CHAPTER "4-Col Layout" LAYOUT { COLS 4 ALIGN OVER TAB } GROUP "2-Column Group" { LAYOUT { COLS 2 ALIGN OVER TAB } PROPERTY "G1"{ EDIT Boolean LENGTH 1 DEFAULT "F"} PROPERTY "G2"{EDIT Boolean LENGTH 1 DEFAULT "F"} PROPERTY "G3"{ EDIT Boolean LENGTH 1 DEFAULT "F"} PROPERTY "G4"{ EDIT Boolean LENGTH 1 DEFAULT "F"} } GROUP "1-Column Group" { LAYOUT { COLS 1 ALIGN OVER TAB } PROPERTY "Group Property 5"{ EDIT Text Length 10} PROPERTY "Group Property 6"{ EDIT Text Length 10} } PROPERTY "My Property 7"{ EDIT Text Length 5} PROPERTY "My Property 8"{ EDIT Text Length 5} PROPERTY "My Property 9"{ EDIT Text Length 5} PROPERTY "My Property 10"{ EDIT Text Length 5} PROPERTY "My Property 11"{ EDIT Text Length 1200} PROPERTY "My Property 12"{ EDIT Text Length 1200} CHAPTER "2-Column Layout" LAYOUT { COLS 2 ALIGN LABEL TAB } PROPERTY "My Property 13"{ EDIT Text Length 10} PROPERTY "My Property 14"{ EDIT Text Length 10} PROPERTY "My Property 15"{ EDIT Text Length 10} PROPERTY "My Property 16"{ EDIT Text Length 10} PROPERTY "My Property 17"{ EDIT Text Length 10} GROUP "3-Column Group" { LAYOUT { COLS 3 ALIGN OVER TAB } PROPERTY "G5"{ EDIT Boolean LENGTH 1 DEFAULT "T"} PROPERTY "G6"{ EDIT Boolean LENGTH 1 DEFAULT "T"} PROPERTY "G7"{ EDIT Boolean LENGTH 1 DEFAULT "T"} PROPERTY "G8"{ EDIT Boolean LENGTH 1 DEFAULT "T"} } CHAPTER "3-Column Layout" LAYOUT { COLS 3 ALIGN OVER TAB } PROPERTY "My Property 18"{ EDIT Text Length 10} PROPERTY "My Property 19"{ EDIT Text Length 10} PROPERTY "My Property 20"{ EDIT Text Length 10} PROPERTY "My Property 21"{ EDIT Text Length 10} PROPERTY "My Property 22"{ EDIT Text Length 10} PROPERTY "My Property 23"{ EDIT Text Length 10} }
The effect of this USRPROPS.TXT code is shown in the figures below.
First LAYOUT command is ignored since it is not assigned to a CHAPTER (tab)
The following figure shows that the top layout command in the Definition, LAYOUT { COLS 3 ALIGN OVER TAB }, is ignored, since it is not assigned to any CHAPTER and it cannot override the layout of the first “Introduction” tab, which is set to default to a 1-column layout.
The second tab in the dialog is specified by the CHAPTER "4-Col Layout" command. Its layout is specified as being 4-columns, with the title or label of each control placed over the control (CHAPTER "4-Col Layout" LAYOUT { COLS 4 ALIGN OVER TAB }.
4-column chapter containing 2-column and 1-column groups
The following figure shows that even entire groups (such as “2-Column Group” and “1-Column Group” are laid out in the Chapter within a 4-column layout, as are properties (such as “My Property 7" through “My Property 10". Properties that are too wide to fit in the 4-column layout scheme are laid out by 1 column (such as “My Property 11" and “My Property 12", which are both Length 1200).
2-column chapter containing 3-column group
The 2-column Chapter, similarly, contains properties laid out in 2 columns, including a Group, within which properties are laid out in 3 columns.
2‑column chapter containing 3-column group
The final Chapter contains properties in a 3-column layout. Note that these properties are narrow enough (Length 10) to fit in 3 columns.
2-Column Chapter Containing 3-Column Group, with one wide property
If any of these properties were too wide to fit in a 3-column layout, that property would be laid out independently of the others, in a 1-column format. Changing “My Property 20" from LENGTH 10 to LENGTH 100 causes its control to be displayed as shown in the following figure. All other properties in the dialog remain laid out in 3-columns.
