GET LIST ITEM PROPERTIES

Home

4D v20 R7


GET LIST ITEM PROPERTIES ( {* ;} Liste ; EintragRef \| * ; Eingebbar {; NeuerStil {; Icon {; Farbe}}} )

Parameter	Typ	Beschreibung
*	Operator	Mit * ist Liste ein Objektname (String) Ohne * ist Liste eine Listenreferenznummer
Liste	ListRef, String	Referenznummer der Liste (ohne ) oder Objektname der Liste (mit )
EintragRef \| *	Operator, Lange Ganzzahl	Referenznummer des Eintrags oder 0 für zuletzt hinzugefügten Eintrag oder * für den aktuellen Eintrag der Liste
Eingebbar	Boolean	TRUE = Eingebbar, FALSE = Nicht-eingebbar
NeuerStil	Lange Ganzzahl	Schriftstil für den Eintrag
Icon	Text, Lange Ganzzahl	131072 + Bildreferenznummer
Farbe	Lange Ganzzahl	Wert für RGB-Farbe

Beschreibung

Der Befehl GET LIST ITEM PROPERTIES gibt die Eigenschaften des Eintrags zurück mit der in EintragRef übergebenen Referenznummer oder Objektname, die in Liste übergeben sind.

Übergeben Sie den ersten optionalen Parameter *, ist der Parameter Liste der Objektname (String) der Darstellung einer Liste im Formular. Geben Sie diesen Parameter nicht an, ist Liste die Referenznummer einer hierarchischen Liste (ListRef). Verwenden Sie nur eine einzige Darstellung der Liste oder arbeiten mit Strukturzeilen (der zweite * ist nicht übergeben), können Sie beide Arten verwenden. Verwenden Sie dagegen mehrere Darstellungen derselben Liste und arbeiten mit der aktellen Zeile (der zweite * ist übergeben), müssen Sie die Syntax mit dem Objektnamen verwenden, da jede Darstellung eine eigene aktuelle Zeile haben kann.

Hinweis: Verwenden Sie das Zeichen @ im Namen der Liste, erhalten Sie einen Satz Objekte im Formular, zu denen der Name passt. GET LIST ITEM PROPERTIES wird aber nur auf das erste Objekt mit dem passenden Namen angewandt.

In EintragRef können Sie entweder eine Referenznummer zuweisen, den Wert 0 für den zuletzt hinzugefügten Eintrag in die Liste oder * für den aktuellen Wert in die Liste. Wurden mehrere Einträge ausgewählt, ist der zuletzt ausgewählte Eintrag der aktuelle.

Übergeben Sie * und ist kein Eintrag ausgewählt oder gibt es keinen Eintrag mit der zugewiesenen Referenznummer, behält der Befehl die Parameter unverändert bei.

Arbeiten Sie mit Referenznummern, sollten diese einmalig sein, damit Sie die Einträge voneinander unterscheiden können. Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl APPEND TO LIST.

Nach dem Aufruf gilt folgendes:

Eingebbar gibt TRUE zurück, wenn der Eintrag eingebbar ist.
Stil gibt den Schriftstil des Eintrags zurück
Icon gibt das dem Eintrag zugewiesene Bild zurück (falls vorhanden):
- Wurde das Icon mit einer Bilddatei angegeben, gibt der Befehl in Icon den Pfadnamen mit der Syntax path:<filesystem path> zurück.
- Wurde das Icon über ein Bild aus Bildbibliothek definiert (nur binäre Struktur), gibt der Befehl Nummer oder Name des Bildes zurück, je nach dem übergebenen Variablentyp. Für Name wird die Syntax pictlib:<name> verwendet. Weisen Sie keinen spezifischen Typ zu, wird standardmäßig der Name des Bildes zurückgegeben (Text). Wurde dem Eintrag kein Icon zugewiesen, gibt der Befehl einen leeren Wert zurück.
  
  Hinweis: Mit dem Befehl GET LIST ITEM ICON können Sie in einer Bildvariablen das Icon herausfinden, das einem Eintrag zugeordnet ist.

Farbe gibt die Farbe des Textes für den angegebenen Eintrag zurück.

Weitere Informationen zu diesen Eigenschaften finden Sie in der Beschreibung zum Befehl SET LIST ITEM PROPERTIES.

Siehe auch

GET LIST ITEM
GET LIST ITEM ICON
SET LIST ITEM
SET LIST ITEM PROPERTIES