GET LIST ITEM PARAMETER ARRAYS

Home

4D v16.3


GET LIST ITEM PARAMETER ARRAYS ( {* ;} Liste ; EintragRef ; arrAuswahl {; arrWerte} )

Parameter	Typ	Beschreibung
*	Operator	Mit : Liste ist ein Objektname (String) Ohne : Liste ist eine Listenreferenznummer
Liste	ListRef, String	Mit : Name des Listentyp Objekts ohne : Listenreferenznummer
EintragRef	Lange Ganzzahl, Operator	Referenznummer des Eintrags oder 0 für den letzten in der Liste angefügten Eintrag oder * für den aktuellen Listeneintrag
arrAuswahl	Array Text	Array der Parameternamen
arrWerte	Array Text	Array der Parameterwerte

Beschreibung

Der Befehl GET LIST ITEM PARAMETER ARRAYS findet alle Parameter in einer einzelnen Zelle - optional auch die Werte, die dem Eintrag EintragRef in der hierarchischen Liste zugeordnet sind, dessen Referenz bzw. Objektname im Parameter Liste übergeben ist.

Den Einträgen zugewiesene Parameter speichern zusätzliche Information zu jedem Eintrag. Sie werden mit dem Befehl SET LIST ITEM PARAMETER gesetzt.
Übergeben Sie den ersten optionalen Parameter *, ist Liste ein Objektname (String), der der Listendarstellung im Formular entspricht. Ohne diesen Parameter ist Liste eine Referenz auf die hierarchische Liste (ListRef). Benutzen Sie eine einzelne Listendarstellung oder arbeiten mit Struktureinträgen (zweiter * wird weggelassen), können Sie beide Syntaxarten verwenden. Benutzen Sie dagegen mehrere Darstellungen derselben Liste und arbeiten mit dem aktuellen Eintrag (zweiter * ist übergeben), müssen Sie die Syntax für den Objektnamen verwenden, da jede Darstellung einen anderen aktuellen Eintrag haben kann.

GET LIST ITEM PARAMETER ARRAYS gibt Parameter für den Eintrag EintragRef im Array Text arrAuswahl zurück. Ist das Array Text arrWerte übergeben, gibt der Befehl die diesen Parametern zugewiesenen Werte zurück.
arrWerte muss ein Array vom Typ Text sein. Sind andere Werte zugeordnet (Zahl oder Boolean), werden sie in Strings umgewandelt (Wahr="1", Falsch="0").

Beispiel

Nehmen wir folgende hierarchische Liste:

 <>HL:=New list

 $ID:=30

 APPEND TO LIST(<>HL;"Martin";$ID)

  //5 parameters

 SET LIST ITEM PARAMETER(<>HL;$ID;"Vorname";"Phil")

 SET LIST ITEM PARAMETER(<>HL;$ID;"Geburtstag";"01/02/1978")

 SET LIST ITEM PARAMETER(<>HL;$ID;"Männlich";True) //Boolean

 SET LIST ITEM PARAMETER(<>HL;$ID;"Alter";33) //number

 SET LIST ITEM PARAMETER(<>HL;$ID;"Stadt";"Dallas")

Zur Vereinfachung wurde die Liste einem Listenobjekt mit demselben Namen (<>HL) zugewiesen.
Wird der Eintrag "Martin" in der Liste ausgewählt, können Sie die dazugehörigen Parameter mit folgendem Code herausfinden:

 ARRAY TEXT(arrParamNames;0)

 GET LIST ITEM PARAMETER ARRAYS(*;"<>HL";*;arrParamNames)

  // arrParamNames{1} enthält "Vorname"

  // arrParamNames{2} enthält "Geburtstag"

  // arrParamNames{3} enthält "Männlich"

  // arrParamNames{4} enthält "Alter"

  // arrParamNames{5} enthält "Stadt"

Wollen Sie auch die Parameter Werte erhalten, schreiben Sie:

 ARRAY TEXT(arrParamNames;0)

 ARRAY TEXT(arrParamValues;0)

 GET LIST ITEM PARAMETER ARRAYS(*;"<>HL";*;arrParamNames;arrParamValues)

  // arrParamValues{1} enthält "Phil"

  // arrParamValues{2} enthält "01/02/1978"

  // arrParamValues{3} enthält "1"

  // arrParamValues{4} enthält "33"

  // arrParamValues{5} enthält "Dallas"

Siehe auch

SET LIST ITEM PARAMETER