Keep Layout State (KeepLayout)

Window property that controls whether layout information is kept. Values are True (default) or False.

Value Description
True Layout may be stored in memory or the Registry. The exact location depends on the value of the Layout State Storage property. For more information, see Layout State Storage (LAYOUTSTORAGE).
False If set to False for the Form, do not save the Form's layout state information.

If set to False for both the Form and the Grid widget, do not save state information.

If set to False for the Form, but True for the Grid widget, save state information as if Layout State Storage is set to Instance.

Description

The Keep Layout State property is applicable only if the History initialization setting is on, or is not defined. If History is off, the layout is not saved at all, neither in memory nor in the Registry. Uniface behaves as if Keep Layout State is switched off on all forms and in all Grid widgets.

Note:  Keep Layout State is ignored when forms are started in the test environment. The layout state is not saved.

Keep Layout State is available as a window property for Form components and as a widget property for the Grid widget. The Keep Layout State on the form level has no influence on the Keep Layout State property of the Grid widget.

If a Form contains split bars and a Grid widget, the Keep Layout State must be True for both the Form and the Grid widget for all layout state information to be saved. If it is True only for the Form, the split bar state is saved but not the Grid widget state. If it is True only for the Grid widget, the split bar location is not saved, but the Grid layout is.

Grid Widget

When defined for a Grid widget. the layout state is stored as determined by the component-level Layout State Storage property. The state of the Grid is not saved in the Registry if the Layout State Storage property of the component is defined as PROCESS.

Applies to

Related Topics