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.