Layout Property

Sets the rendering engine used to layout the form.

object.Layout = [value]

Where object is an object expression that evaluates to one of the controls in the Applies To list, and value is a constant as described in Settings.

Client support

Newlook Smartclient

Newlook Server

Version Support

Layout property introduced in Version 10.1.3.

LayoutClassicAbsolute setting introduced in 11.0.5.

Use

The layout property allows the user to select the layout engine used to render controls on the form.

This property is a design-time only property.

Settings

The available settings for value for this property are :

Constant	Description
LayoutClassic	(Default) The LayoutClassic option is the traditional method of layout used by Newlook. With this option, the layout engine adjusts the position of controls automatically if the screen is busy, new controls have been added to the underlying host screen or the screen has been designed at something other than the default size (via the Format > Device menu option). This layout engine was designed back in the early days of Newlook with small monitors in mind, where it was important to create as much white spacing as possible on busy screens, and minimize the work involved in doing so. Be Aware: The down-side of using this layout option is that controls are never guaranteed to stay in a fixed location. This is especially so if controls have been repositioned and saved multiple times. In addition, this layout engine uses the default design-size of a screen to calculate control positioning, therefore setting the screen to a custom size in Designer (for use in Server) may cause controls to move unexpectedly.
LayoutClassicEnhanced	The LayoutClassicEnhanced option was introduced to fix the issue where controls were automatically repositioned on custom-sized forms designed for Newlook Server. This option is recommended, when you want to use the classic (dynamic) layout engine and your screen has been designed at something other than the default size (via the Format > Device menu option). Choosing the LayoutClassicEnhanced option ensures that moved or sized controls will retain their position values after the form is saved. This layout option is not relevant for Smartclient.
LayoutClassicAbsolute	(Introduced in 11.0.5) The LayoutClassicAbsolute option locks existing controls in position on the form, as they are when the override is saved. An individual control will not move when another control on the form is moved, the form is re-sized or a new field appears in the underlying host screen. This option is recommended if the position of controls on the form is important. Be Aware: The down-side of using the LayoutClassicAbsolute layout engine is that if a new field appears in the underlying host screen, controls may overlap in the resulting GUI form. You will need to manually re-position any overlapping fields in the override.

Applies To

Form object