3.15 DM_Destroy

Mit Hilfe dieser Funktion können beliebige Objekte oder Modelle innerhalb des Dialogs gelöscht werden. Dabei werden alle Kinder des Objekts mit gelöscht. Mit Hilfe des zweiten Parameters wird gesteuert, was gelöscht werden soll.

DM_Boolean DML_default DM_EXPORT DM_Destroy
(
  DM_ID objectID,
  DM_Options options
)

Parameter

-> DM_ID objectID

In diesem Parameter wird das Objekt angegeben, das gelöscht werden soll.

-> DM_Options options

Über diesen Parameter wird gesteuert, welches Verhalten beim Löschen gefordert ist. Dabei gibt es folgende Möglichkeiten:

Option

Bedeutung

DMF_ForceDestroy

Wenn als Option DMF_ForceDestroy angegeben wird, werden das Objekt gelöscht und alle Regelteile, die dieses Objekt benutzen, abgeändert, sodass 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 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

TRUE

Objekt konnte gelöscht werden.

FALSE

Objekt konnte nicht gelöscht werden.

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

Beispiel

Zerstören eines Objektes von einer C-Funktion aus.

DM_Boolean DML_default DM_ENTRY DestroyObject

(

    DM_ID ObjID

)

{

  return (DM_Destroy(ObjID, DMF_ForceDestroy));

}

Siehe auch

Eingebaute Funktion destroy() im Handbuch „Regelsprache“

Methode :destroy()