Main Index  PREV  NEXT

Delete Forms

Delete 1 - delete occurrence unless there are subordinates

Description

This form has no dialog with the User other than with the ASKMESS command.

This form is usually called from a LIST form with the primary key of a single occurrence as the parameter. The form will retrieve the selected occurrence and any subordinate (child) occurrences.

If any subordinate entries exist an error message will be generated and the deletion will be cancelled.

If there are no subordinate entries the User will be asked to confirm the deletion to which the response is one of the following:-

• YES - the selected occurrence will be deleted from the database and a message will be sent to the parent form to this effect so that the parent can update its own screen display.
• NO - the form will exit without deleting the occurrence.

Buttons

Contents

Bound Objects

Local Constants (Refer to Local Constants)

Component Variables (Refer to Component Variables)

Delete 2 - delete occurrence including subordinates

Description

This form has no dialog with the User other than with the ASKMESS command.

This form is usually called from a LIST form with the primary key of a single occurrence as the parameter. The form will retrieve the selected occurrence and any subordinate (child) occurrences.

The User will be asked to confirm the deletion to which the response is one of the following:-

• YES - the selected occurrence and all subordinate occurrences will be deleted from the database and a message will be sent to the parent form to this effect so that the parent can update its own screen display.
• NO - the form will exit without deleting the occurrence.

Buttons

Contents

Bound Objects

Local Constants (Refer to Local Constants)

Component Variables (Refer to Component Variables)

Delete 3 - validate occurrence for deletion

Description

This form has no dialog with the User.

This form is usually called from a MULTI-PURPOSE form with the primary key of a single occurrence as the parameter. The form will retrieve the selected occurrence and any subordinate (child) occurrences.

If there are no subordinate entries the form will return to the parent with a zero status.

If any subordinate entries exist an error message will be generated and the form will return to the parent with a non-zero status.

The values returned in $status are:-

• =0 - the deletion can proceed. It is up to the parent form to carry out the deletion and update the database.
• <0 - the deletion is to be cancelled.

Buttons

N/A

Contents

Bound Objects

Local Constants (Refer to Local Constants)

Component Variables (Refer to Component Variables)

http://www.tonymarston.net