OBJECT GET SUBFORM
OBJECT GET SUBFORM ( * ; object : Text ; tablePtr : Table ; detailSubform : Text {; listSubform : Text} )
OBJECT GET SUBFORM ( object : Variable, Field ; tablePtr : Table ; detailSubform : Text {; listSubform : Text} )
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | → | If specified, object is an object name (string)If omitted, object is a variable |
| object | Text, Variable, Field | → | Object name (if * is specified) or Variable or field (if * is omitted) |
| tablePtr | Table | ← | Pointer to table of form |
| detailSubform | Text | ← | Name of detail form of subform |
| listSubform | Text | ← | Name of list form of subform (table form) |
History
| Release | Changes |
|---|---|
| 16 R6 | Modified |
| 13 | Created |
Description
The OBJECT GET SUBFORM command gets the name(s) of the form(s) associated with the subform object designated by the object and * parameters.
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 tablePtr parameter, the command returns a pointer to the table of the form(s) used. If the subform uses a project form, this parameter contains Is nil pointer.
In the detailSubform and (optionally) listSubform parameters, the command returns:
- the form name if the subform was created in the 4D form editor.
- the subform's "name" attribute if the subform was created from a .json file or a 4D object.
In both cases, if the "name" attribute is undefined, the command will return:- for a .json file, the name of the .json file (without extension)
- for an object, "untitled"
If there is no list form, an empty string is returned in the listSubform parameter.
See also
OBJECT GET SUBFORM CONTAINER SIZE
OBJECT SET SUBFORM
Properties
| Command number | 1139 |
| Thread safe | no |