6.8.13 DMcob_Destroy

Any object or model of the dialog can be deleted with this function. All object children are also deleted.

77  DM-object  pic 9 (9) binary.

call "DMcob_Destroy" using
            DM-StdArgs
            DM-object.

Parameters

-> DM-Object

The ID of the object you want to delete.

-> DM-Options

Controls the function behavior during the deletion.

DMF-ForceDestroy:

If DMF-ForceDestroy is given here, the object is deleted and all rule parts using this object are changed, so that the corresponding commands are removed.

If the object to be deleted is a model, using this function without DMF-ForceDestroy prohibits only a new reference to this model; the model itself remains. If DMF-ForceDestroy is used, the model is removed from all objects using it and the objects adopt the values of the next superordinate model or default.

Return Value

DM-status of DM-StdArgs

DMcob_Destroy() invokes the :clean() method of the object to be destroyed.

Example

Deleting a window MyWindow.

    move DMF-Forcedestroy to DM-Options.

    Call "DMcob_DestroyObject" using DM-StdArgs DM-object.

See Also

Built-in function destroy() in manual “Rule Language”

Method :destroy()