4D v14.3

EXECUTE METHOD IN SUBFORM

Home

 
4D v14.3
EXECUTE METHOD IN SUBFORM

EXECUTE METHOD IN SUBFORM 


 

EXECUTE METHOD IN SUBFORM ( UnterformularObjekt ; MethodenName {; Rückgabe {; Parameter} {; Parameter2 ; ... ; ParameterN}} ) 
Parameter Typ   Beschreibung
UnterformularObjekt  Text in Name des Objekts Unterformular
MethodenName  Text in Name der auszuführenden Projektmethode
Rückgabe  Operator, Variable in Von der Methode zurückgegebener Wert oder
in * wenn Methode keinen Wert zurückgibt.
Parameter  Variable in Parameter, die der Methode übergeben werden sollen

Der Befehl EXECUTE METHOD IN SUBFORM führt die Projektmethode MethodenName im Kontext des Objekts UnterformularObjekt aus. 

Die aufgerufene Projektmethode kann in Parameter Werte von 1 bis X empfangen und in Rückgabe einen Wert zurückgeben. Übergeben Sie * im Parameter Rückgabe, wenn die Methode keine Parameter zurückgibt.
Sie können den Namen jeder Projektmethode übergeben, die über die Anwendung oder die Komponente, welche den Befehl ausführt, verfügbar ist. Der Kontext der Ausführung wird in der aufgerufenen Methode beibehalten, d.h. das aktuelle Formular sowie Formularereignis bleiben definiert. Kommt das Unterformular von einer Komponente, muss die Methode zur Komponente gehören und die Eigenschaft "von Komponente und Host Datenbank gemeinsam genutzt" haben.
Dieser Befehl muss in der Formularmethode des Elternformulars mit dem Objekt UnterformularObjekt aufgerufen werden.

Hinweis: Die Methode MethodenName wird nicht ausgeführt, wenn UnterformularObjekt in der aktuellen Seite nicht gefunden wird.

Wurde der Befehl korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).

Wir gehen aus vom Formular "KundeDetail", das im Elternformular "Firma" als Unterformular verwendet wird. Das Objekt Unterformular mit dem Formular KundeDetail lautet "KundeUnterformular". Wir wollen nun die Darstellung bestimmter Elemente im Unterformular je nach Wert des Feldes Firma verändern: "Kundenname" soll in Rot wechseln, wenn gilt [Firma]Stadt="Berlin" und in Blau, wenn gilt [Firma]Stadt="Frankfurt". Diese Operation wird über die Methode SetToColor integriert. Um dieses Ergebnis zu erreichen, kann die Methode SetToColor nicht direkt über das Formularereignis "On Load" des Elternformulars Firma ausgeführt werden, da das Objekt "Kundenname" nicht zum aktuellen Formular, sondern zum Objekt Unterformular "KundeUnterformular" gehört. Von daher muss die Methode, damit sie korrekt funktioniert, über den Befehl EXECUTE METHOD IN SUBFORM ausgeführt werden.

 Case of
    :(Form event=On Load)
       Case of
          :([Firma]Stadt ="Berlin")
             $Color:=$Red
          :([Firma]Stadt ="Frankfurt")
             $Color:=$Blue
          Else
             $Color:=$Black
       End case
       EXECUTE METHOD IN SUBFORM("KundeUnterformular";"SetToColor";*;$Color)
 End case

Sie entwickeln eine Datenbank, die als Komponente verwendet wird. Sie enthält ein gemeinsam genutztes Projektformular, z.B. Kalender. Es enthält dynamische Variablen sowie eine öffentliche Projektmethode, um den Kalender anzupassen: SetCalendarDate(varDate).
Würde diese Methode direkt in der Formularmethode Kalender verwendet, könnten Sie sie direkt im Formularereignis "On Load" aufrufen:

 SetCalendarDate(Current date)

Im Kontext der Host Datenbank kann es passieren, dass ein Projektformular zwei "Kalender" Unterformulare, z.B. in den Unterformularobjekten mit Namen "Kal1" und "Kal2" enthält. Sie müssen das Datum von Kal1 auf 01/01/10 und das Datum von Kal2 auf 05/05/10 setzen. Sie können die Methode SetCalendarDate nicht direkt aufrufen, weil die Methode nicht weiß, welche Formulare und Variablen sie verwenden soll. Deshalb müssen Sie sie über folgenden Code aufrufen: 

 EXECUTE METHOD IN SUBFORM("Cal1";"SetCalendarDate";*;!01/01/10!)
 EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/10!)

Fortgeschrittenes Beispiel: Im selben Kontext wie oben zeigt dieses Beispiel eine generische Methode:

  // Inhalt der Methode SetCalendarDate
 C_DATE($1)
 C_TEXT($2)
 Case of
    :(Count parameters=1)
  // Standardausführung der Methode (als ob sie vom Formular selbst ausgeführt wurde)
  // oder speziell für einen Kontext (siehe Fall 2)
 
    :(Count parameters=2)
  //  Externer Aufruf, benötigt einen Kontext
  // Rekursiver Aufruf mit nur einem Parameter
       EXECUTE METHOD IN SUBFORM($2;"SetCalendarDate";*;$1)
 End case

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Programmiersprache
Nummer: 1085

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

Erstellt: 4D v12

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)