Layout Properties

3D

If set to true, the control is shown in 3D.

Object inspector

<Boolean>

Alignment

Alignment for the text in the control.

Object inspector

<Left Justify | center justify | right justify>

AlsoSendOnTransmit

(IBM CICS BMS Only)
For CicsBms forms the content of label objects that have a 'Caption' property set will not be sent upon transmit by default.
By setting AlsoSendOnTransmit to true, the label content will be sent on transmit even if it has a initial value (Caption) set.

The screen copy wizard will add label objects to the screen copy depending on this property and the 'Caption' property.

Alt Shortcuts

If set to "True", "&" is automatically converted to a shortcut. When the user presses the ALT-shortcut, the cursor will be focused on the control that is defined with the property 'FocusControl'.

Object inspector

<Boolean>

borderstyle

borderstyle for the control to show.

Object inspector

<Single | underline | none>

Caption

Text to appear in the control.

By adding an ampersand (&) before a character, that specific character will be marked as a shortcut character. At runtime, the concerned character will then appear underlined. Subsequently, the end user can invoke the shortcut functionality through the keyboard combination Alt + <Underlined character>. If the concerned shortcut belongs to a label, it will shift the focus to the control that is defined through the property focuscontrol.

Object inspector

<Text>

CharWidth

Determines the space per character. This property does not change the character presentation, which means that characters are not stretched when choosing a higher property value.

Object inspector

<Numeric>

Color

Background color to give to the control. This property can also be set for a whole form layout (including all available layout controls) at once.

When <default> is chosen in the object inspector the color of the Parent layout control will be used.

In the object inspector it is also possible to open a colour picker window to select a custom colour by clicking on the "..." button to the right of the dropdown menu.

By adding a colour to the custom colors set, multiple custom colours can be quickly selected.

Object inspector

<Numeric>
(other values that can be chosen in the object inspector will be converted automatically to a numeric value)

ColorEdit

Background color for the edit fields that are shown through the dynamic form which are not blinked or disabled.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorEditBlink

Background color for the blinked edit fields that are shown through the dynamic form.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorEditDisabled

Background color for the disabled edit fields that are shown through the dynamic form.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorEditFont

Font color for the edit items that are shown through the dynamic form.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorEditReverse

Background color for the edit items that are reversed.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorLabelBlink

Color for the blinked label items that are shown through the dynamic form.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorLabelFont

Color for the non-blinked label items that are shown through the dynamic form.

Object inspector

<Numeric>
(see also the value description for the Color property)

ColorLabelReverse

Color for the label items that are reversed.

Object inspector

<Numeric>
(see also the value description for the Color property)

Columns

The number of columns for the dynamic form. This value determines the width of the dynamic form.

Object inspector

<Numeric>

DecimalChar

Character that is used as separator in decimal values.

Object inspector

<Default | period | comma>

Decimals

Number of decimal characters to assign to the control value.

Object inspector

<Integer>

Description

Description of the control.

Object inspector

<Text>

Enabled

Boolean value that indicates if the control or (sub) item is enabled. If set to "False", the control or item will be greyed out and disabled at runtime.         

Object inspector

<Boolean>

Encrypted  

The Encrypted property of a specific control item or element. If set the transmission of data between the Application Server and the Web Client will be encrypted.
To use encryption this has to be configured in the ControlCenter under Security Configuration > Encryption. See Encryption

FocusControl

Name of the control that must be focussed when the user presses the ALT-Shortcut combination (according to the shortcut setting in the caption definition of the label). This setting only works at runtime if the property "Alt Shortcuts" is set to TRUE.

Object inspector

<String>

Font

Name, style, size, effects, color and script for the font used in the control or the form. This property can also be set for a whole form layout (including the available layout controls) at once.

The fonts to choose from are the available fonts of the client machine the AMT Developer Studio is running on.

When a chosen font is not available on the client machine AMT Screens is running on (for Reports the server the batch controller is running on and for the webclient the client machine the webbrowser is running on) the Windows default font of that client/server will be used. If that replacement font is wider then your desired font, field sizes will be expanded to fit.

To add fonts, right-click on the font file and select the 'Install for all users' option under 'Show more options'. This will ensure that all AMT components will have access to the font.

By clicking on the "..." button to the right of the colour dropdown menu, a colour picker window is opened where it is possible to select a custom colour. For more information, see the color property.

Object inspector

Values are chosen from the 'font box' that is called by clicking the button that is displayed on the right of the fontproperty in the object inspector.

ForceDecimalKey

If set to true, then values that are specified in the layout control will be rejected if they don't contain the decimal character.

If set to false, the decimals may be omitted.

If set to default, this option will work according to the global setting.

Object inspector

<Default | true | false | none>

Format

Specification of how variables are to be translated to alpha fields. See Layout Property Format.

Object inspector

<Format specification>

Height

Height of the control or form.

Object inspector

<Integer>

HelpText

Text to appear as a hint for the control that is displayed on the cursors position.
The HelpText appears in a pop up window when "F1" is pressed except when an alternative Help Command has been defined in Applications settings tab Help Command.

Object inspector

<String>

HyperColor

Color to be used for hyperlinks. This property applies to all layout controls that are available on a form.

Object inspector

<Numeric>
(other values that can be chosen in the object inspector will be converted automatically to a numeric value)

HyperLink

Specification of the web address to be opened when the end user clicks on the layout control. The hyperlink value may refer to a URL with either a http:// or a https:// prefix.

Object inspector

<URL>

Default text/value that is assigned to a memo control.
This multi line text can be entered after clicking on the '...' button.

InitialValue

Default value that is assigned to the control.

Intensified

(IBM CICS BMS Only)
Setting 'Intensified' to true will enable the intensified attribute for that layout object. Depending on this property and the 'Enabled' property, one of five css classes in the amt.css file will be used to display the layout object on runtime.

The following table shows which css class will be used, were a protected field being a field that can not be keyed into on runtime.

Please note that if the protected attribute is set on an editbox, an additional class is also used to change the appearance of this field, namely .CIbmCobolTextBoxProtected.

ItemsValuesImages

Settings for each separate element in a buttongroup.

The following settings apply:

• Item: defines the text (String) that is displayed in the button.
• Value: defines the value that is sent when the button is activated at runtime. The value type depends on the type that is set for the buttongroup.
• Image location: defines the place in the button where the image must be displayed (either Left, Center, Right, Stretch). When choosing "Stretch", the image will be stretched to fill the whole button.
• Image: Reference to the image that must be displayed on certain button states. References are added by clicking on the arrow under the concerned state(s), selecting an image object and then the image to be displayed.

One button is defined as default.

When referring to the value in your code, please be aware that this value is CASE SENSITIVE.

Object inspector

See description.

Layout

If set to Horizontal, the itemgroup is shown as a row. With all the items sized equally.
If set to Horizontal auto scale, the itemgroup is shown as a row. With all the items sized depending on their caption length.
If set to Vertical, the itemgroup is shown as a column.

Object inspector

<Horizontal | Horizontal auto scale | Vertical>

Left

Number of pixels space before the control. If the control is related to a parent, then the number of space is measured from the beginning (left) of the parent until the beginning of the control. Otherwise, the space is measured from the beginning of the form or report. 

Object inspector

<Integer>

Length

Maximal number of characters to give to the control value(s).

Object inspector

<Integer>

LineHeight

The height of a single line (in number of pixels).

Object inspector

<Numeric>

Name

Name of the control.

Object inspector

<Text>

Numeric can be empty

When set to true the value of the Numeric may also be all spaces, otherwise only digits are allowed.

Note: when set to true the initial value of the numeric will be empty, otherwise zero.

Object inspector

<Boolean>

OccursData

Occurrence settings for the layout control.

The settings for the horizontal occurs determine the number of elements that appear next to each other and the offset (number of pixels space) between these elements.

The settings for the vertical occurs determine the number of control elements that appear under each other and the offset (number of pixels space) between these elements.

If in a screen layout, the Form Offset option is selected, the offset will be set to the value that is specified for the form properties OccursOffsetHorz and OccursOffsetVert.

Object inspector

<Text>

OccursOffsetHorz

The offset (in number of pixels) between control elements that are grouped horizontally. This option applies to all controls on the form that have the Form Offset option for the horizontal occurs selected.

Object inspector

<Integer>

OccursOffsetVert

The offset (in number of pixels) between control elements that are grouped vertically. This option applies to all controls on the form that have the Form Offset option for the vertical occurs selected.

Object inspector

<Integer>

Pages

The number of pages to be included in the dynamic form. Every new page may be regarded as the follow up for the previous page. Through the code, control characters are used for pointing to a specific page (the same as for the Terminal screens, on which the Dynamic Forms functionality is based).

Object inspector

<Numeric>
(between 1 and 9)

Parent

Control to which one or more child controls are related to.

Object inspector

<String>

Password

If set to "True", the user input will be displayed as asterisks (*) within the control.

Object inspector

<Boolean>

ReadOnly

If set to "True", endusers are not allowed to write to the control or change the color of the text that is displayed in the layout control. If set as false, users have both read and write permission.               

Object inspector

<Boolean>

Rows

The number of rows that is presented on a dynamic form, not including the StatusLine.

Object inspector

<Numeric>

SdfAttributes

(A-Series SDF Only)
By enabling a SDF Field Attribute for the layout object, it is possible to change that attribute value on runtime.
Checking a field attribute adds a flag field to the working storage buffer, this flag field can then be (re)set by the COBOL code on runtime.

SDF Field Attributes:

• Highlight: enable/disable the high intensity of the field.
• Specify: Reserved for future implementation.
• Suppress: Makes a field visible or invisible.
• Data Only: Reserved for future implementation.
• Cursor: Places the cursor in the field.
• No Input: Reserved for future implementation.
• I/O type: Enables or disables the field.


• Boolean: Marks a field as Boolean. Alphanumeric fields that are marked as Boolean will be defined as a numeric computational with length 1 in the form data buffer. 
• Comp: Marks a field as numeric computational type. Numeric fields that are marked as comp will use Bcd based values (half byte) in the form data buffer.

ShowBorder

Determines whether or not there must be displayed a border around the layout control.

Object inspector

<Boolean>

ShowLeadingZeros

The number of leading zeros to be displayed or printed (depending on the kind of layout includes the layout control).
If set to "none", no zero will be displayed or printed for the numeric value.
If set to "one", a zero will only be shown if the value is zero.
If set to "all", and the value contains less characters than the valuelength supports, the value is completed with leading zeros until the full valuelength is displayed or printed.
If set to "all except 0" the value will show all leading zeros, except when the value is 0.

Object inspector

<None | one | all | all except 0>

StatusLine

If set to "true", the dynamic form is enlarged with an additional status line that is shown below each page of the dynamic form. Through the code, control characters are used for pointing to the status line. This property is used in the conversion of terminal screens that use dynamic delimiters.

Object inspector

<Boolean>

TabNumber

Number that is given to different controls to assign the order to move the cursor from one control to the next when the user hits the TAB key.

The tabnumber value for layout controls can be reset instantly to a value based on the screen position or the position within a specific group. This can be done through a right mouse click on the layout screen (while selecting a specific group or selecting no layout control at all), selecting the option "Taborder" and then choosing "Auto tab". The tabnumber value for the control on the top left of the screen or the concerned group will then be reset to "0". The order will then in first instance be determined based on the horizontal position and then on the vertical position. The highest value will be assigned to the item on the bottom right.

Another option to make sure that the screen will be tabbed through from the top left to the bottom right can be found in the form options. By selecting the switch "Calculate taborder based on left-top", you make sure that the layout controls are always tabbed through according to their screen position. The tabnumber property will then be overruled.

Please note that controls for which the Tabstop property has been set to FALSE are always excluded from tabbing.

Object inspector

<Numeric>

TabStop

When tabbing through the layout at runtime and this property is to "False", the cursor will not be put in the concerned control.

Object inspector

<Boolean>

ThousandSeparator

Separator that is displayed in numeric values between every three digits counted from the right.

Object inspector

<Default | period | comma | apostrophe | none>

Title

Text to display on top of the control.

Object inspector

<Text>

Top

Position where the control is painted or printed. If the control is related to a parent, the value indicates the number of pixels between the top position of the control and the top position its parent. Otherwise, the value indicates the number of pixels between the top of the control and the top of the form or report.

Object inspector

<Integer>

Type

Valid type for the control.

Object inspector

(Types that have a fixed length)
<Alpha | numeric | financial | signed | Boolean>

(types that don't have a fixed length)
<String | integer>

Transparent

If set to True, only the text of the control will be displayed. The background will be completely transparent.

Object inspector

<Boolean>

UnderlineWholeField

Applies to all layout controls on the applicable form for which the Underline property is set for the Font. Only if "Underline whole field" is set to "True", the underline applies for the whole length of the control. Otherwise, only the text that is displayed in the field will be underlined.

Object inspector

<Boolean>

UpperCase

If set as "True", the value will be converted to UPPERCASE.

Object inspector

<Boolean>

Visible

If set "False", then the control will not be shown at runtime.

Object inspector

<Boolean>

Width

Horizontal size of the control or form.

Object inspector

<Integer>

WordWrap

If set to true, the text that is printed or displayed in the control wraps when the right margin is reached. The text continues at the next line.
If set to false, return characters must be entered explicitly to show the text on the next line.

Object inspector

<Boolean>

WSOrder

(A-Series SDF Only)
The order number of this object in the working storage form buffer.
The WSOrder property is used together with the Top and Left position of an object to determine the order of all objects in the Working Storage form buffer. The objects are sorted in the following order: WSOrder , Top , Left.

For example, an object with the WSOrder value of 2 will correspond to the second item in the working storage form buffer.

Multiple objects can have the same WSOrder value. If so, then their order is determined based on the Top and Left position. Objects with the same WSOrder values will cause the objects with a higher order number to be moved down the Working storage form buffer, this facilitates adding objects to the form without having to renumber the WSOrder value of every object.

A WSOrder of 0 (zero) is used to indicate that the object does not exist in the Working Storage form buffer, this can be used for label objects as an example.

Object inspector

ZOrder

Controls the order of visual objects to display one object over another.

For example, changing the ZOrder of a visual object to 1 will display that object over another that is set to 0. Negative numbers are accepted.

Object inspector

<Integer>