4D Doc Center : MODIFY SUBRECORD

4D v13.4

MODIFY SUBRECORD


MODIFY SUBRECORD ( subtable ; form {; *} )

subtable	Subtable	Subtable to use for data entry
form	String	Form to use for data entry
*		Hide scroll bars

Compatibility Note

Subtables are no longer supported starting with version 11 of 4D. A compatibility mechanism ensures the functioning of this command in converted databases; however, it is strongly recommended to replace any subtables with standard related tables.

Description

The MODIFY SUBRECORD command displays the current subrecord of subtable for modification using the form form. The form must belong to subtable.

A current record for the parent table must exist. If a current parent record does not exist for the process, MODIFY SUBRECORD has no effect. In addition, if there is no current subrecord, then MODIFY SUBRECORD does nothing.

Any modifications made to the subrecord will actually only be saved if the parent record itself is saved.

After a call to MODIFY SUBRECORD, OK is set to 1 if the subrecord modifications are accepted, to 0 if canceled.

The form is displayed in the frontmost window of the process. The window has scroll bars and a size box. Specifying the optional * parameter causes the window to be drawn without scroll bars or a size box.

System variables and sets

Accepting the subrecord modifications sets the OK system variable to 1; canceling it sets the OK system variable to 0.