6.8.9 DMcob_CreateFromModel

Mit dieser Funktion können beliebige, auf einem Modell basierende, Objekte als Instanz oder Modell erzeugt werden.

Die Parameter definieren das Modell, von dem das neu erzeugte Objekt abgeleitet wird, sowie den Vater und den Objekttyp (Instanz oder Modell) des neu erzeugten Objekts.

77  DM-objectid  pic 9(9)  binary value 0.
77  DM-parentid  pic 9(9)  binary value 0.
77  DM-modelid   pic 9(9)  binary value 0.

call "DMcob_CreateFromModel" using
            DM-StdArgs
            DM-objectid
            DM-parentid
            DM-modelid.

Parameter

-> DM-Options of DM-StdArgs

Folgende Optionen können angegeben werden, wobei mehrere Optionen mit oder verknüpft werden können:

Option

Bedeutung

0

Es wird eine Instanz erzeugt.

DMF-CreateModel

Es wird ein Modell erzeugt.

DMF-CreateInvisible

Das neu generierte Objekt wird, unabhängig von der Definition im Modell oder Default, unsichtbar erzeugt.

<- DM-objectid

In diesem Parameter wird der Identifikator des neu erzeugten Objekts zurückgegeben.

-> DM-parentid

Dieser Parameter definiert den Vater des neu erzeugten Objekts.

-> DM-modelid

Dieser Parameter definiert das Modell, von dem das neu erzeugte Objekt abgeleitet wird. Wenn es sich um ein hierarchisches Modell handelt, werden dessen Kinder auch im neu erzeugten Objekt angelegt.

Rückgabewert

DM-status of DM-StdArgs

DM-error

Objekt konnte nicht generiert werden.

DM-success

Objekt konnte generiert werden.

Verfügbarkeit

Die Funktion DMcob_CreateFromModel ist ab IDM-Version A.06.01.g verfügbar.

Siehe auch

Funktion DMcob_CreateObject

Eingebaute Funktion create() im Handbuch „Regelsprache“

Methode :create()