Show TOC Entering content frame

Background documentation Properties of a Choice-List Control Locate the document in its SAP Library structure

You need to specify the following properties for a choice-input control.

Two sets of properties are explained in this document. The first is for the Choice-List Control, and the second is for the Associated Popups to a Choice Control dialog box.

Choice Input Property

Action

Blankable

Select True if the user can clear the control’s input field at runtime.

Select False if the user cannot clear the control’s field at runtime.

Note

The Input Field Editable property must be set to True.

BO Attribute  

Enter the name of the property of a data source that you want to associate this control.

Data Type

Set the control’s data type.

Note

The data type is derived from the BO attribute’s data type.

Input Field Editable

Select True if the user can edit the control’s input field at runtime.

Select False if the user cannot edit the control’s field at runtime.

Invoked Popup Window
(appears when you select Linked Popups)

Specify the tile set displayed by choosing the choice-list control at runtime.

IsGridColumn

Select True if the choice-input control is a column within the grid control.

Select False if the choice-input control is displayed outside the grid.

Note

This property is displayed in tile of type Extended List.

Label

Enter a name for the label of the choice input field. For example, Last Name.

Linked Popups

Select the list of find/choice and custom popup tile sets that you want to appear in the selection box at runtime.

For more information about the Linked Popups fields and options, see the Associate popups to a choice control table.

Maximum Length

Specify the maximum number of characters that can be entered or displayed in the choice-input field.

Mode
(required)

Set the mode for the control.

If set to …

Then …

Normal

 

The control is active at runtime and the user can choose the associated popup tile set.

Readonly

The control is not active at runtime and the user can only read the data displayed in the choice- input field.

Hidden

The choice-input field is not displayed at runtime.

Mandatory

The user must select a value in the choice-input field at runtime.

Name
(required)

Enter a name with the assigned namespace.

Offset

Enter the width in pixels between the end of the label text and the choice-input field.

Tab Order

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

Target Attribute (required)

Specify the primary key used to select the data record, based on the selection made in the popup window. The data type must be compatible with the primary key returned by the popup window.

Top, Left, Bottom, Right
(required)

Enter the coordinates based on the position of the control. The value you set for Top automatically determines the value for Bottom.

Use Long Text

Select True if you want the long text of the associated combo engine to display in the control’s input field.

Select False if you want the Display Attribute or the BO Attribute text to display in the control’s input field.

Associate Popups to a Choice Control

You need to specify the following properties for an associated popup tile set.

Field/Option Name

Description

Select custom popups

Displays the list of find/choice and custom popup tile sets that you select to appear in the selection box at runtime.

Details

Displays the properties of the tile set currently selected in the list.

Show selected

Displays only the tile sets that you have selected.

Alternative key
(required only when the Target Attribute does not specify a unique key)

Displays the attributes of the popup window’s data source in a select list. Select the property required to identify the record to be returned to the choice-list control.

Display Attribute

Displays the attributes of a popup window’s data source in a selection list. The property you select displays in the choice-list input field to reflect the choice the user makes at runtime.

Note

If no display attribute is assigned, the primary key of the record returned by the popup window determines BO attribute.

Query Attribute

Displays the attribute of the underlying Business Query.

Default Invoked Popup Window

Displays as selected for the tile set in the list that is used as the default tile set returned at runtime. You can change the selection.

See also:

 

Defining a Choice-List Control

Leaving content frame