Subform

---

Allow Deletion

Specifies if the user can delete subrecords in a list subform.

JSON Grammar

Name	Data Type	Possible Values
deletableInList	boolean	true, false (default: true)

Objects Supported

Subform

---

Detail Form

You use this property to declare the detail form to use in the subform. It can be:

• a widget, i.e. a page-type subform endowed with specific functions. In this case, the list subform and Source properties must be empty or not present.
  You can select a component form name when it is published in the component.

You can generate components providing additional functionalities through subforms.

• the detail form to associate a with the list subform. The detail form can be used to enter or view subrecords. It generally contains more information than the list subform. Naturally, the detail form must belong to the same table as the subform. You normally use an Output form as the list form and an Input form as the detail form. If you do not specify the form to use for full page entry, 4D automatically uses the default Input format of the table.

JSON Grammar

Name	Data Type	Possible Values
detailForm	string	Name (string) of table or project form, a POSIX path (string) to a .json file describing the form, or an object describing the form

Objects Supported

Subform

---

Double-click on empty row

Action to perform in case of a double-click on an empty line of a list subform. The following options are available:

• Do nothing: Ignores double-click.
• Add Record: Creates a new record in the subform and changes to editing mode. The record will be created directly in the list if the Enterable in List property is enabled. Otherwise, it will be created in page mode, in the detail form associated with the subform.

JSON Grammar

Name	Data Type	Possible Values
doubleClickInEmptyAreaAction	string	"addSubrecord" or "" to do nothing

Objects Supported

Subform

See also

Double click on row

---

Double-click on row

List subform

Sets the action to be performed when a user double-clicks on a row in a list subform. The available options are:

• Do nothing (default): Double-clicking a row does not trigger any automatic action.
• Edit Record: Double-clicking a row displays the corresponding record in the detail form defined for the list subform. The record is opened in read-write mode so it can be modified.
• Display Record: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified.

Regardless of the action selected/chosen, the On Double clicked form event is generated.

For the last two actions, the On Open Detail form event is also generated. The On Close Detail is then generated when a record displayed in the detail form associated with the list box is about to be closed (regardless of whether or not the record was modified).

JSON Grammar

Name	Data Type	Possible Values
doubleClickInRowAction	string	"editSubrecord", "displaySubrecord"

Objects Supported

Subform

See also

Double click on empty row

---

Enterable in list

When a list subform has this property enabled, the user can modify record data directly in the list, without having to use the associated detail form.

To do this, simply click twice on the field to be modified in order to switch it to editing mode (make sure to leave enough time between the two clicks so as not to generate a double-click).

JSON Grammar

Name	Data Type	Possible Values
enterableInList	boolean	true, false

Objects Supported

Subform

---

List Form

You use this property to declare the list form to use in the subform. A list subform lets you enter, view, and modify data in other tables.

List subforms can be used for data entry in two ways: the user can enter data directly in the subform, or enter it in an input form. In this configuration, the form used as the subform is referred to as the List form. The input form is referred to as the Detail form.

JSON Grammar

Name	Data Type	Possible Values
listForm	string	Name (string) of table or project form, a POSIX path (string) to a .json file describing the form, or an object describing the form

Objects Supported

Subform

---

Source

Specifies the table that the list subform belongs to (if any).

JSON Grammar

Name	Data Type	Possible Values
table	string	4D table name, or "" if no table.

Objects Supported

Subform

---

Selection Mode

Designates the option for allowing users to select rows:

• None: Rows cannot be selected if this mode is chosen. Clicking on the list will have no effect unless the Enterable in list option is enabled. The navigation keys only cause the list to scroll; the On Selection Change form event is not generated.
• Single: One row at a time can be selected in this mode. Clicking on a row will select it. A Ctrl+click (Windows) or Command+click (macOS) on a row toggles its state (between selected or not).
  The Up and Down arrow keys select the previous/next row in the list. The other navigation keys scroll the list. The On Selection Change form event is generated every time the current row is changed.
• Multiple: Several rows can be selected simultaneously in this mode.
  • The selected subrecords are returned by the GET HIGHLIGHTED RECORDS command.
  • Clicking on the record will select it, but it does not modify the current record.
  • A Ctrl+click (Windows) or Command+click (macOS) on a record toggles its state (between selected or not). The Up and Down arrow keys select the previous/next record in the list. The other navigation keys scroll the list. The On Selection Change form event is generated every time the selected record is changed.

JSON Grammar

Name	Data Type	Possible Values
selectionMode	string	"multiple", "single", "none"

Objects Supported

Subform