Skip to main content
Version: Next

FORM EDIT

FORM EDIT ( {aTable ;} form )
FORM EDIT ( {aTable ;} form ; object )

ParameterTypeDescription
aTableTableTable owning the form or If omitted: default table or use of project form
formTextForm name
objectTextForm object name or group name
History
ReleaseChanges
20 R8Support of object parameter

Description

The FORM EDIT command opens the form associated to aTable in the 4D Form editor, with optionnally object selected. Note that you must have access to the Design environment, otherwise the error -9804 ("Cannot open form") is generated.

The command is asynchronous: it returns immediately to the calling method and does not wait for the form to be open.

If you pass the optional aTable parameter, you indicate the table associated with form. If you omit this parameter, you indicate that form is a project form.

In the form parameter, pass the name of the form to open in the 4D Form editor. If you pass a name that does not exist, the error 81 is generated ("Form not found").

Optionnally, you can pass in object the name of a form object or of a group to select automatically in the 4D Form editor. This feature allows you, for example, to save time when debugging a form based upon expression errors returned by Compile project.

If object is not found in form, the form is opened and no error is returned.

Pass an empty string in object to deselect all objects in the open form.

Examples

To open the Contacts table Address form:

 FORM EDIT([Contacts];"Address")

To open the ContactList project form:

 FORM EDIT("ContactList")

To open the ContactPage project form with "name-input" object selected:

 FORM EDIT("ContactList"; "name-input")

See also

Design Object Access Commands

Properties

Command number1749
Thread safe