Information

Created By	Knowledge Migration User

Approval Process Status	Published

Objective

Description

GUI Output Form Properties (Magic xpa 3.x)

GUI Output forms must be Class > 0.

You can access the GUI Output Form Properties sheet by:

Selecting Edit/Properties from a Form Editor entry with a GUI Output interface type.
Pressing Alt+Enter from a Form Editor entry with a GUI Output interface type.
Selecting Properties from the context menu while on a Form Editor entry with a GUI Ouput interface type.
Double clicking on the GUI Output form grid.

The GUI Output form properties are as follows:

Model

The Model property lets you select another model, display the default form properties, and inherit or disinherit properties.

Form Units

You define the size and position of forms in terms of units of measurement. Units of measurement also specify the resolution of the form. You can define a form in: dialog units, centimeters, or inches.

Vertical Factor

The Vertical Factor specifies the vertical resolution within each unit of measurement. A higher value gives a finer resolution.

Horizontal Factor

The Horizontal Factor specifies the horizontal resolution within each unit of measurement. A higher value gives a finer resolution.

Show Grid

Defines whether the Form Editor will display the dot grid. If you enter a Yes value, the form layout will appear with a grid. If you enter a No value, the form layout will appear without a grid.

Grid X,
Grid Y

Defines the distance between the grid dots on the form.

Form Name

This is the Name in the Form Editor. This Name appears in the title bar of the form. You have the option to select an expression that, when evaluated at runtime, returns the form title.

Area

For interactive windows, Class 0 forms, the Area field is disabled. For report forms, the Area field can be set to Detail (the default), Header, Footer, Page Header, or Page Footer. For I/O record layout forms, the field is disabled.

The physical placement (nesting) of Header, Detail, and Footer forms in the Form Editor is important. Each header form must be followed by its matching footer form. All header-footer pairs must precede the detail lines. The header-footer pairs must appear in their outside-in nested order. The detail lines should be placed after the innermost header-footer forms pair. Detail forms should appear in the order they appear on the report. When displayed within the report editor, Magic xpa orders the forms to their output format of nested header, detail, footer, reflecting the sequence in which they appear on the report.

Expand Form

If you have a form that you want to print and the fields are dynamic in size, you can use the following options in the Expand Form property to dynamically adjust the size of the form:

No – The form will not expand.

One page – The form will expand its size up to a single page to make room for new lines in the multi-line Edit control.

Multi-page – The form will expand across multiple pages to fit all the lines of the Edit control (with no limit). The table row will expand when the data will not fit on one row.

Note:

This property only works on graphical output.
Sometimes in the Print Previewer, the last line of the wrapped field will not show correctly. This is an issue with the Print Previewer, but the report will work correctly when it goes to a printer.
Expanded controls in a table will be printed on multiple pages only if the form does not contain expanded controls outside the table. In this case, the Expand Form property will behave as if set to One page.
Rich Edit controls will not print multiple pages, since the data cannot be cut between pages. In this case, the Expand Form property will behave as if set to One page.