Destroying Forms

Last Updated: 9/19/2008

Sections above here:
Home » Development » Form Management

Sections below here:

Topics in this section:
Form Management
User Controls
IntraWeb Frame
Managing Forms
Form List
Showing Forms
Hiding Forms
Destroying Forms
Passing Data

In a normal Delphi application when a form is no longer needed it can be destroyed using the .Free or the .Destroy methods.

In an IntraWeb application it is similar, however you must not call the .Free or .Destroy methods directly. Instead you must call the .Release method. The .Release method does not actually destroy the form when called. The form will not be destroyed until the event exits and returns control to IntraWeb. This is because .Release is usually called from within and event of the form itself, although this is not always the case.

After release is called, just like in a normal application the active form becomes the one that was active prior to the destroyed form became active. If you do not wish to return the user to the prior form you must call the .Show method for a different form.

The .Show method can be called before or after .Release since neither takes effect until control is returned back to IntraWeb.

When a form is released, all references to it in the form list are removed. This causes an alteration in the order of the forms that will be shown when forms are hidden or released with no explicit .Show method calls.