6.8.10 DMcob_CreateObject

Mit dieser Funktion können Objekte einer beliebigen Objektklasse als Instanz oder Modell erzeugt werden.

Die Parameter definieren die Objektklasse (Pushbutton, Fenster usw.), 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-classid   pic X(2)  value "??".

call "DMcob_CreateObject" using
            DM-StdArgs
            DM-objectid
            DM-parentid
            DM-classid.

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 Default, unsichtbar erzeugt.

DMF-InheritFromModel

Diese Option war vorgesehen, um ein Objekt auf Basis eines im classid-Parameter angegebenen Modells zu erzeugen.

DMF_InheritFromModel sollte allerdings nicht verwendet werden.

Stattdessen sollten Objekte, die von einem Modell abgeleitet sind, mit der Funktion DMcob_CreateFromModel erzeugt werden.

<- 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-classid

Dieser Parameter legt die Klasse des neuen Objekts fest. Alle Konstanten für die Klassendefinitionen sind in der Datei IDMcobws.cob, die mit dem IDM ausgeliefert wird, enthalten.

Wertebereich

  • DM-Class-Application
  • DM-Class-Canvas
  • DM-Class-Check (Checkbox)
  • DM-Class-Doccursor
  • DM-Class-Document
  • DM-Class-Editext (Edittext)
  • DM-Class-Filereq
  • DM-Class-Groupbox
  • DM-Class-Image
  • DM-Class-Layoutbox
  • DM-Class-Listbox
  • DM-Class-Mapping
  • DM-Class-Menubox
  • DM-Class-Menuitem
  • DM-Class-Menusep
  • DM-Class-Messagebox
  • DM-Class-Notebook
  • DM-Class-Notepage
  • DM-Class-Poptext
  • DM-Class-Progressbar
  • DM-Class-Push (Pushbutton)
  • DM-Class-Radio (Radiobutton)
  • DM-Class-Record
  • DM-Class-Rect (Rectangle)
  • DM-Class-Scroll (Scrollbar)
  • DM-Class-Spinbox
  • DM-Class-Splitbox
  • DM-Class-Statext (Statictext)
  • DM-Class-Statusbar
  • DM-Class-Tablefield
  • DM-Class-Timer
  • DM-Class-Toolbar
  • DM-Class-Transformer
  • DM-Class-Treeview
  • DM-Class-Window

Rückgabewert

DM-status of DM-StdArgs

DM-error

Objekt konnte nicht generiert werden.

DM-success

Objekt konnte generiert werden.

Beispiel

Es soll ein neues Fenster generiert werden.

Call "DMcob_CreateObject" using DM-StdArgs
    DM-newobject DM-dialogID DM-CLass-Window.

Siehe auch

Funktion DMcob_CreateFromModel

Eingebaute Funktion create() im Handbuch „Regelsprache“

Methode :create()