6.8.13 DMcob_Destroy

Mit Hilfe dieser Funktion können beliebige Objekte oder Modelle des Dialogs gelöscht werden. Dabei werden alle Kinder des Objektes mit gelöscht.

77  DM-object  pic 9(9)  binary.

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

Parameter

-> DM-Object

Identifikator des Objekts, welches Sie löschen wollen.

-> DM-Options of DM-StdArgs

Kontrolliert das Verhalten der Funktion beim Löschen.

DMF-ForceDestroy

Wenn zu dieser Option DMF-ForceDestroy angegeben wird, wird das Objekt gelöscht und alle Regelteile, die dieses Objekt benutzen, abgeändert, so dass die entsprechenden Anweisungen entfernt werden.

Falls es sich bei dem zu löschenden Objekt um ein Modell handelt, wird ohne den Parameter DMF-ForceDestroy nur die erneute Referenzierung des Modells verboten, aber es bleibt weiterhin als Modell bestehen. Wird hierbei aber DMF‑ForceDestroy angegeben, so wird bei allen Objekten, die dieses Modell benutzen, dieses Modell entfernt, und sie übernehmen wieder die Werte des nächsthöheren Modells bzw. Defaults.

Rückgabewert

DM-status of DM-StdArgs

DMcob_Destroy() ruft die :clean()-Methode des zu zerstörenden Objekts auf.

Beispiel

Es soll das Fenster MyWindow gelöscht werden.

    move DMF-ForceDestroy to DM-Options.

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

Siehe auch

Eingebaute Funktion destroy() im Handbuch „Regelsprache“

Methode :destroy()