Layout-Manager

This property associates a Layout Manager with the Ribbon. Three types of Layout Managers (defined in the isresize.def Copybook) are supported.

•	LM-RESIZE automatically resizes and moves controls where the window is resized, allowing to cover all the space available.

•	LM-SCALE moves and resizes controls proportionally to the new dimensions of the window.

For each resize action:

deltaX = current window size / previous window size,

deltaY = current window lines / previous window lines.

For each control:

RESIZE-X	size = previous size * deltaX.
RESIZE-Y	lines = previous lines * deltaY.
MOVE-X	column = previous column * deltaX.
MOVE-Y	line = previous line* deltaY.

If the Layout-Data property is not set, each control has its own default behavior.

The list below describes the default behavior of each control:

BAR	MOVE-BOTH-ANY
BITMAP	MOVE-BOTH-ANY
CHECK-BOX	MOVE-BOTH-ANY
COMBO-BOX	MOVE-BOTH-ANY + RESIZE-X-ANY
DATE-ENTRY	MOVE-BOTH-ANY
ENTRY-FIELD	MOVE-BOTH-ANY + RESIZE-X-ANY
ENTRY-FIELD Multiline	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
FRAME	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
GRID	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
JAVA-BEAN	MOVE-BOTH-ANY
LABEL	MOVE-BOTH-ANY
LIST-BOX	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
PUSH-BUTTON	MOVE-BOTH-ANY
RADIO-BUTTON	MOVE-BOTH-ANY
SCROLL-BAR HORIZONTAL	MOVE-BOTH-ANY + RESIZE-X-ANY
SCROLL-BAR VERTICAL	MOVE-BOTH-ANY + RESIZE-Y-ANY
SLIDER HORIZONTAL	MOVE-BOTH-ANY + RESIZE-X-ANY
SLIDER VERTICAL	MOVE-BOTH-ANY + RESIZE-Y-ANY
TAB CONTROL	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
TREE-VIEW	MOVE-BOTH-ANY + RESIZE-BOTH-ANY
WEB-BROWSER	MOVE-BOTH-ANY + RESIZE-BOTH-ANY

The user can also specify custom values for some controls directly in the handle definition, without using the Layout-Data property.

Example:

77 h-layout handle of layout-manager, lm-scale "configuration string".

A sample configuration string is provided in the isresize.def Copybook.

The configuration string is composed by a series of <control-type>=<value> separated by a spaces or comma.

<control-type>=<value> must be a unique word. No space may be put inside. The string is case insensitive.

Example:

77 h-layout handle of layout-manager lm-scale "bar=119 textarea=119 label=119 frame=119".

The list below describes the <control-type> you can use in the configuration string.

BAR	bar
BITMAP	bitmap
CHECK-BOX	checkbox
COMBO-BOX	combobox
DATE-ENTRY	dateentry
ENTRY-FIELD	entryfield
ENTRY-FIELD Multiline	textarea
ENTRY-FIELD SPINNER	spinner
FRAME	frame
GRID	grid
JAVA-BEAN	javabean
LABEL	label
LIST-BOX	listbox
PUSH-BUTTON	pushbutton
RADIO-BUTTON	radiobutton
HORIZONTAL SCROLLBAR	hscrollbar
VERTICAL SCROLLBAR	vscrollbar
HORIZONTAL SLIDER	hslider
VERTICAL SLIDER	vslider
TAB CONTROL	tab
TREE-VIEW	treeview
WEB-BROWSER	webbrowser

<value> is a numeric value that is the sum of the constant values that must be used for the control.

In the above sample, 119 is the sum between rlm-resize-x, rlm-move-x, rlm-no-min-x, rlm-resize-y, rlm-move-y, rlm-no-min-y.

Note: inquiring controls Lines and Size properties after the window has been resized returns the initial values and not the new values when the Layout-Manager is LM-SCALE.

•	LM-WRAP automatically redistribute controls on multiple lines where the window is resized, allowing to cover all the space available.

 

Example - Display a Ribbon control with layout manager

procedure division. ...   display ribbon           tab-to-add ( "Ops 1" "Ops 2")           bitmap-number ( 0 0)           lines 4.4375           color 134           enabled 0           id 6           hint "Ribbon tool bar"           collapse 1           header-align 1           layout-manager lm-resize           bitmap-width 18           bitmap-handle icon-png           handle screen-1-rbn-1-hdl           . ...