Combo-Input Control Property

Action

BO Attribute
(required)

Set the data source property associated with this control. You can select a different property, if required.

Bound Column

Determine the column with the value that is inserted into the combo-input text field when the user selects an entry from the drop-down list at runtime. You can choose only from columns which have names specified in the List Columns properties.

The combo input drop-down list has two columns, Country ID and Country Name, in the Country combo-input field and you have specified Country ID as the Bound Column.

At runtime, if the user selects the value United States, the value US will be displayed in the combo-input field.

Caption Enabled

Select True if you want the caption displayed in the drop-down list of the combo.

Select False if you do not want the caption displayed in the drop-down list of the combo.

Hyperlink Source

If you want to add a hyperlink to this field, enter the name of the hyperlink. For more information, see Creating a Hyperlink.

Label
(required)

Enter a name to be used as the label of the combo-input field.

List Columns

Choose Selection.

The List Column Properties dialog box appears.

See the List Column Property table for specifying these properties.

Mode
(required)

Set the mode for the control.

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

·        Select Normal to display data and allow selection of a different value in the combo-input field at runtime.

·        Select Readonly to display data in the combo-input field at runtime.

·        Select Hidden to hide the combo-input field at runtime.

·        Select Mandatory if the user must select a value in the combo-input field.

The mode can change at runtime based on the mode set for the business object property or business query property. For example, you have set the mode to Normal. If the business object property is Readonly, the control changes the mode to Readonly at 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 combo-input control. This also determines the space between the end of the label name and the field.

Tab Order

Enter a sequence number.

This determines 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.

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.

The positioning of the control varies, depending on the tile type you select.

Tile Type

Position Information

Detail

The control is placed in the absolute position.

List

Position of the control is based on the Tab Order property and not on these coordinates.

Type
(required)

Set the type for the control.

By default, the type is derived from the data type of the assigned BO Attribute.

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

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

Use Long Text
(required)

Select True if  you want the long text of the combo engine associated to the BO Attribute property displayed in the control’s text field.

This is valid only if the:

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

·        Combo-input control is not part of the grid

Select False if you want the BO Attribute text displayed in the control’s text field.

This is valid for all properties specified in BO Attribute.

List Column Property

Action

ColCaption

Enter the caption for the column. If you want the user to see this caption at runtime, set the Caption Enabled property to True.

List Property

Enter the Short Text Field Name or Long Text Field Name of the combo engine associated to the property specified in the BO Attribute property.

You can find this information in the following way.

·         Identify the value specified in the BO Attribute property.

·         Identify to which business object / business query it belongs to.

·         In the Object Modeler, navigate to the identified business object/business query property and find out the combo engine associated to it.

·         In the Object Modeler, navigate to the identified combo engine and view its details.

You will find the Short Text Field Name or Long Text Field Name here.

Name

Enter a name for the column with the assigned namespace. This name will be used as a value in the Bound Columns property.

Width

Enter the width of the column.

Combo-Control Property

Action

List Width

Enter the entire width of the drop-down list. This property can be used to set the drop-down list width, which is different from the combo-input control width.

Validate Combo

Select True if you want to allow the user to enter a value in the combo field that also exists in the drop-down list. By default, this property is set to True.

Select False if you want to allow the user to enter any value in the combo field. In this case, the combo-input control does not compare the input with the drop-down list.