The FORM objects

The FORM objects provide methods to arrange Terminal MGui objects as buttons, edit fields etc.

PosForm

This basic container does not provide automatic child positioning, the application is responsible of assigning the desired position to each child.
Using MGui Designer you can move objects within a PosForm container in the 'Actual Layout Window' by dragging them while the 'Shift' key is pressed.
The input focus switching sequence reflects by default the order child objects are inserted into the container. If you need to change this order you have to reorder the PosForm children operating in the Hierarchy Area.
 

RowForm

This basic container arranges its children by putting them on successive rows (all in a single column).
 

ColForm

This basic container arranges its children by putting them on successive columns (all in a single row).
 

TableForm

This basic container arranges its children by putting them on successive columns and wrapping to a new row as the number of Table columns is reached for the current row.
The dialog window below is opened at creation time to let you specify the desired number of table columns.




ScrolledForm

This container provides scrolling facilities in both horizontal and vertical directions. A dialog window pops up when you create this kind of object to allow the selection of the initial clipping dimensions along  with the base children arrangement policy (Pos/Row/Col).

By deactivating the toggle button 'Clip Width' ('Clip Height') you actually disable the horizontal (vertical) scrollbar.
 

PagedForm

Sometimes it's necessary to display different sets of objects in the same area in a dialog window. Think to a typical 'wizard' dialog.
In these cases you can use the PagedForm container provided by MGui.
At creation time you have to supply the number of desired pages along with the base children arrangement policy (Pos/Row/Col).

In order to switch between pages you have to open the 'Object Specific' dialog window and choose the desired page number.

TabbedForm

TabbedForm is an extension of the PagedForm because it provides selection tabs in the top to allow the user navigate the pages. Text in the tabs can be assigned using the generic object editing window. Simply select the desired tab/page and apply the new text value to the TabbedForm object.
 

Basic FORM Editing dialog

By double-clicking on a basic FORM object in the hierarchy area, or selecting the 'Object Specific' item in the 'Attributes' menu, you'll get the FORM editing dialog window.
Child spacing is by default 3 pixels. In case of a PosForm, the 'Child spacing' value acts as a snap value while moving a child object. By pressing the 'Ctrl' key while moving will cause the snap to be disabled.
The 'Focus highlight' option forces the Form to draw a black border in its boundaries when any of the children inside it owns the input focus.
By disabling the 'Focus wrap' option, the Form will circulate the input focus to its children when arrow keys are used to navigate objects.

The Auto ScrollBar color button is available in case of ScrolledForm object. By enabling this option the color of buttons and slider in the scrollbars will be set automatically based on the ScrolledForm background color.
The brightness of such computed color will be optimized.


TableForm Editing dialog

The TableForm editing dialog adds the possibility to change the number of columns in the table and to display/hide the matrix grid.


PagedForm/TabbedForm Editing dialog

This dialog allows you to change the number of pages in a Paged (Tabbed) Form and to select the current page.

WARNING: by reducing the number of pages you actually destroy all objects belonging to removed pages.