FORMLOAD

8.1, PLBCMP GUI Only

The FORMLOAD instruction loads and activates a PLFORM object. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

form

Required. A previously defined PLFORM object.

target

Required. A WINDOW object, a pointer to a WINDOW object, a PANEL, or a pointer to a PANEL object to which the objects-only form is attached.

Flags Affected: none

Note the following:

1. The {form} must have been generated by Sunbelt's PLBDSIGN utility.

2. The {form} is both created and activated.

3. If {form} is a MODAL window, the optional {target} specification is ignored. Otherwise, the form is attached to the optionally specified WINDOW or PANEL.

4. If {form} is a MDI child window, a {target} WINDOW parameter is required.

5. If {target} is a WINDOW and not of type PRIMARY, an O134 error is given.

6. If {target} is a PANEL, {form} must be an objects-only form or an O119 error with a subcode of 46 occurs.

7. Any window events specified in an objects-only PLF form are registered for the target panel or window object of the FORMLOAD.

See Also: Example Code, DESTROY, Object Instructions