2.11 :create()

Mit Hilfe dieser Methode können zur Laufzeit neue Objekte generiert werden. Die Methode liefert als Ergebnis das neu generierte Objekt zurück.

Definition

object :create
(
      object  Parent input
  { , object  Dialog    := null  input }
  { , integer Type      := 3     input }
  { , boolean Invisible := false input }
)

Parameter

object Parent input
Dieser Parameter bezeichnet den Vater des Objekts.
object Dialog := null input
Dieser optionale Parameter bezeichnet den Dialog, zu dem das Objekt gehören soll.
integer Type := 3 input

Mit diesem optionalen Parameter können Sie angeben, ob Sie einen Default, ein Modell oder eine Instanz erzeugen wollen.

Wertebereich

1
erzeugt einen Default
2
erzeugt ein Modell
3
erzeugt eine Instanz

Wenn dieser Parameter nicht angegeben ist, wird automatisch eine Instanz generiert.

boolean Invisible := false input

In diesem optionalen Parameter wird angegeben, ob das Objekt unsichtbar oder wie in der Vorlage definiert generiert werden soll.

Wertebereich

true
Das Objekt wird immer unsichtbar angelegt.
false
Die Sichtbarkeit wird vom Modell oder Default übernommen.

Rückgabewert

objectId
Id des neu generierten Objekts.
null
Null-ID, da das Objekt nicht generiert werden konnte.

Beispiel

dialog Beispiel

model window MWnDetail
{
  !! Detailanzeige von Datensaetzen
  .title "Detailanzeige der Daten";
  rule void GetData()
  {
    !! Holen der Daten
    !! Fenster sichtbar machen
    this.visible ::= true;
  }
  child pushbutton PbExit
  {
    .text "&Abbrechen";
    on select
    {
      !! zerstoert das Instanzen-Fenster
      this.window:destroy();
    }
  }
}

window WnMain
{
  .title "Daten\374bersicht";
  child tablefield TfData
  {
    !! enthaelt eine Datenuebersicht
    on dbselect
    {
      variable object NewObj := null;
      
      !! sichtbares Erzeugen
      !! NewObj ::= MWnDetail:create(this.dialog);
      !! unsichtbares Erzeugen
      NewObj ::= MWnDetail:create(this.dialog, true);
      NewObj:GetData();
    }
  }
}

Siehe auch

Eingebaute Funktion create() im Handbuch „Regelsprache“

C-Funktion DM_CreateObject im Handbuch „C-Schnittstelle - Funktionen“

COBOL-Funktion DMcob_CreateObject im Handbuch „COBOL-Schnittstelle“