4D Doc Center : OBJECT SET SUBFORM

4D v13.4

OBJECT SET SUBFORM


OBJECT SET SUBFORM ( {* ;} object {; aTable}; detailSubform {; listSubform} )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a variable
object	Form object	Object Name (if * is specified) or Variable (if * is omitted)
aTable	Table	Table of form (if table form)
detailSubform	Text	Name of detail form of subform
listSubform	Text	Name of list form of subform (table form)

Description

The OBJECT SET SUBFORM command dynamically modifies the detail form as well as, optionally, the screen list form associated with the subform object designated by the object and * parameters.

Note: This command cannot change the type of the subform itself (list or page). This property can only be set in Design mode.

If you pass the optional * parameter, this indicates that the object parameter is an object name (a string). If you do not pass this parameter, this indicates that the object is a variable. In this case, you pass a variable reference instead of a string.

In the aTable parameter, pass the table of the forms to be used. This parameter is optional; you can omit it when you specify a project form as detail subform.

In the detailSubform parameter, pass the name of the form to use as detail subform.

In the listSubform parameter, pass the name of the form to use as list subform. This parameter can only be passed when you modify a list type subform.

When you modify a page subform, the command can be executed at any time; current selections are not modified. However, when you modify a list subform, it can only be modified when it displays the list. If the command is executed when the detail form is displayed following a double-click in the list, an error is generated.