Unload Event

  • Article

Occurs when an object is released.

Unload is the last event to occur before a form set or form is released.

PROCEDURE Object.Unload

Remarks

Unload occurs after the Destroy event and after all the contained objects have been released. In addition, Unload occurs depending on the type of object:

  • Form objects are released in code when the object variable that refers to the form is released or when its form set is released.
  • Form set objects are released in code when the object variable that refers to the form set is released.

If a container object, such as a form set, contains objects, the Unload event for the container object occurs after the Unload events for the objects it contains. For example, a form set containing one form that contains one control (a CommandButton) is released in this order:

  1. FormSetDestroy event
  2. FormDestroy event
  3. CommandButtonDestroy event
  4. FormUnload event
  5. FormSetUnload event

To return a value to the TOVarName clause in the DO FORM command, use the RETURN command in the Unload event. For more information, see DO FORM Command.

See Also

Destroy Event | QueryUnload Event | Destroy Event | DO FORM Command | RETURN Command

Applies To: Form | FormSet