Text-Input Property

Action

Anchor

Choose the anchor that references the data source containing the property that you want to associate with this control.

BCOLFieldName
(appears in a List tile only)

Enter the BDoc segment field.

This is required only if you want the control to display data from different data sources than the data source specified for the grid.

You can associate only one business object to the grid. Therefore, if you want to display data from a different business object, you must enter a segment field name. This segment field must be part of the BDoc segment with which the business object of the grid is associated.

In this case, the BO Attribute property is ignored.

BO Attribute

Specify the data source property that you want to associate with the control.

ColumnNumber
(appears in a List tile only)

Enter the position of the text-input control in the grid.

If you enter 2, the text input field is the second column in the grid.

Data Type
(required)

Set the control’s data type.

The control’s default data type is derived from the data type of the assigned data source property.

Do not use the data types DateTime, Boolean, Text, and Binary. These are not supported at runtime.

For information about the domains Date, Short Date, Medium Date, Long Date, Time, Short Time, Medium Time and Long Time, see Properties of a Date Control and Time Control.

IsGridColumn
(appears in a List tile only)

Select True if you want the control to be contained in the grid

Select False if you want the control to be displayed outside the grid.

Label
(required)

Enter a name to be used as the label of this control.

Maximum Length

Enter a number representing the maximum number of characters which can be entered in the text-input field.

If you enter 0, there is no restriction on the number of characters the field holds.

The length limit entered here does not work if the text-input control is bound to a grid.

Mode
(required)

Set the mode for the control.

The default setting is based on the attribute value of the data source property.

If set to …

Then …

Normal

The control appears and the user can enter a data in the text-input field at runtime.

Readonly

The control displays read-only information in the text-input field at runtime.

Hidden

The text-input control field does not appear at runtime.

Mandatory

The user must enter a value in the text-input field at runtime.

The mode can change at runtime based on the mode set for the data source property.

For example, you have set the mode to Normal. If the business object property is Readonly, the control will change the mode during runtime.

Name
(required)

Enter a name with the assigned namespace. This name is used to access this control in the code.

Offset

Enter the label width of the text-input control.

This information is relevant if the text-input control is used in a grid. If the control is not used in a grid, the Top, Left, Bottom, and Right properties are used.

Tab Order

Enter a number to determine the order in which the control is selected using the Tab key to navigate in a tile.

Top, Left, Bottom, Right
(required)

Set the coordinates based on the position of the control.

In a Detail tile, the control is placed in the absolute position.

In a List tile, the position of the control is based on the Tab Order and ColumnNumber properties and not on these coordinates.

You cannot change the value of the Bottom property. Its value is always equal to the value of the Top property plus a fixed number.

Use Long Text
(required)

Select True if you want the long text of the combo engine associated with the data source property to appear in the control’s text field.

This is valid only if the:

·         Property specified in BO Attribute has a combo engine associated to it

·         Text-input control is not contained in a grid

Select False if you want the short text of the data source property to appear in the control’s text field.

This is valid for all properties specified in BO Attribute.

Select Both if you want the short and long text of the combo engine to appear in the control’s text field.