4D v16.3

OBJECT SET LIST BY NAME

Home

 
4D v16.3
OBJECT SET LIST BY NAME

OBJECT SET LIST BY NAME 


 

OBJECT SET LIST BY NAME ( {* ;} Objekt {; ListeTyp}; Liste ) 
Parameter Typ   Beschreibung
Operator in Mit Stern: Objekt ist Objektname (String)
Ohne Stern: Objekt ist Feld oder Variable
Objekt  Formularobjekt in Objektname (mit *) oder Feld bzw. Variable (ohne *)
ListeTyp  Lange Ganzzahl in Typ der Liste: Auswahlliste, Erforderlich-Liste oder Ausgenommen-Liste
Liste  String in Name der Auswahlliste (wie in Designumgebung definiert)

Der Befehl OBJECT SET LIST BY NAME setzt bzw. ersetzt die in Objekt angegebene Auswahlliste, die einem Objekt oder einer Objektgruppe zugewiesen ist, durch die in Liste übergebene Auswahlliste, wie sie im Listeneditor der Designumgebung definiert wurde.

OBJECT SET LIST BY NAME können Sie für Eingabe- und Ausgabeformulare einsetzen und auf Datenfelder und eingebbare Variablen für Text anwenden. Die Auswahlliste erscheint bei der Dateneingabe, wenn der Benutzer den Textbereich auswählt.

Mit dem optionalen Parameter * geben Sie in Objekt einen Objektnamen (String) an. Ohne den optionalen Parameter * geben Sie in Objekt ein Datenfeld oder eine Variable an. In diesem Fall geben Sie anstatt eines Strings eine Referenz auf das Datenfeld oder die Variable an (nur Datenfeld- oder Variablenobjekte). Weitere Informationen dazu finden Sie im Abschnitt Objekteigenschaften.

Hinweis: Dieser Befehl lässt sich nicht auf Datenfelder in Unterformularen anwenden.

Der Befehl OBJECT SET LIST BY NAME kann alle Listentypen setzen oder ersetzen, die dem bzw. den Objekten zugeordnet sind, definiert durch die Parameter Objekt und *. Das sind Auswahllisten, Listen mit erforderlichen Werten und Listen mit ausgenommenen Werten. Dazu übergeben Sie in ListeTyp eine der folgenden Konstanten unter dem Thema Formularobjekte (Eigenschaften):

Konstante Typ Wert Kommentar
Choice list Lange Ganzzahl 0 Liste zum Auswählen von Werten (Option "Auswahlliste" in der Eigenschaftenliste) (Standard)
Excluded list Lange Ganzzahl 2 Liste mit ausgeschlossenen Werten für die Eingabe (Option "Ausgenommen-Liste" in der Eigenschaftenliste)
Required list Lange Ganzzahl 1 Liste mit erforderlichen Werten für die Eingabe (Option "Erforderlich-Liste" in der Eigenschaftenliste)

Lassen Sie diesen Parameter weg, wird standardmäßig 0 (Auswahlliste) verwendet.

Um im aktuellen Prozess die Zuweisung einer Liste für Objekt aufzuheben, übergeben Sie im Parameter Liste für den entsprechenden Listentyp einen leeren String ("").

Folgendes Beispiel legt eine Auswahlliste für das Datenfeld Lieferanten fest. Bei Übernachtlieferung erscheint die Auswahlliste der Expresslieferanten. Sonst wird die Standardliste angezeigt:

 If([Shipments]Overnight)
    OBJECT SET LIST BY NAME([Shipments]Shipper;"Expresslieferanten")
 Else
    OBJECT SET LIST BY NAME([Shipments]Shipper;"Normale Lieferanten")
 End if

Die Liste "Farbwahl" als einfache PopUp/DropDown-Liste mit Namen "Türfarbe" zuweisen:

 OBJECT SET LIST BY NAME(*;"Türfarbe";Choice list;"Farbwahl")
  // in diesem Fall können Sie den 3. Parameter (Konstante) weglassen

Sie wollen die Liste "Farbwahl" einer Combo Box "Wandfarbe" zuordnen. Da sie eingebbar ist, sollen bestimmte Farben wie "schwarz", "purpur" etc., von der Eingabe ausgeschlossen sein. Diese Farben setzen Sie in die Liste "ausgeschl_Farben":

 OBJECT SET LIST BY NAME(*;"Wandfarbe";Choice list;"Farbwahl")
 OBJECT SET LIST BY NAME(*;"Wandfarbe";Excluded list;"ausgeschl_Farben")

Sie wollen die zugewiesenen Listen entfernen:

  // Die Auswahlliste entfernen
 OBJECT SET LIST BY NAME(*;"Türfarbe";Choice list;"")
  // Die Liste mit nicht-erlaubten Werten entfernen
 OBJECT SET LIST BY NAME(*;"Wandfarbe";Excluded list;"")



Siehe auch 

OBJECT Get list name
OBJECT SET LIST BY REFERENCE

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Objekte (Formulare)
Nummer: 237

 
GESCHICHTE 

Geändert: 4D v6
Umbenannt: 4D v12
Geändert: 4D v14
Umbenannt: 4D v14

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)