SET LIST ITEM PROPERTIES

Home

4D v20.6


SET 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 (ohne )
EintragRef \| *	Operator, Lange Ganzzahl	Referenznummer des Eintrags oder 0 für zuletzt hinzugefügten Eintrag oder * für aktuellen Eintrag der Liste
Eingebbar	Boolean	WAHR = Eingebbar; FALSCH = Nicht eingebbar
NeuerStil	Lange Ganzzahl	Schriftstil des Eintrags
Icon	Text, Lange Ganzzahl	Bildname oder -nummer ("" oder 0 für kein Icon)
Farbe	Lange Ganzzahl	RGB Farbwert oder -1 = Rücksetzen auf Originalfarbe

Beschreibung

Der Befehl SET LIST ITEM PROPERTIES ändert den Eintrag mit der in EintragRef übergebenen Referenznummer in der Liste mit der in Liste übergebenen Referenznummer oder Objektname.

Ü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.

Gibt es keinen Eintrag mit der übergebenen Referenznummer, hat der Befehl keine Auswirkung. Übergeben Sie in EintragRef den optionalen Parameter 0, können Sie mit APPEND TO LIST den zuletzt in der Liste angefügten Eintrag ändern.
Übergeben Sie in EintragRef den optionalen Parameter *, gilt der Befehl für den aktuellen Eintrag in der Liste. Wurden mehrere Einträge manuell ausgewählt, ist der zuletzt ausgewählte Eintrag der aktuelle. Wurde kein Eintrag ausgewählt, führt der Befehl nichts aus.

Arbeiten Sie mit Referenznummern, sollten diese einmalig sein, damit Sie die Einträge unterscheiden können. Weitere Informationen dazu finden Sie im Abschnitt Hierarchische Listen verwalten.

Hinweis: Mit dem Befehl SET LIST ITEM können Sie den Text des Eintrags oder der dazugehörigen Unterlisten ändern.

Übergeben Sie in Eingebbar WAHR, ist der Eintrag eingebbar. Übergeben Sie FALSCH, ist er nicht eingebbar.

Wichtig: Eingebbare Einträge müssen zu einer eingebbaren Liste gehören. Der Befehl OBJECT SET ENTERABLE macht eine ganze Liste eingebbar. Der Befehl SET LIST ITEM PROPERTIES macht einen einzelnen Eintrag der Liste eingebbar. Ändern Sie die Eigenschaft eingebbar für die Liste, hat das keine Auswirkung auf die Eigenschaft der einzelnen Einträge. Ein Eintrag kann jedoch nur eingebbar sein, wenn die dazugehörige Liste eingebbar ist.

Mit dem Parameter Stil legen Sie den Schriftstil des Eintrags fest. Übergeben Sie eine oder mehrere der vordefinierten Konstanten unter dem Thema Schriftstile:

Konstante	Typ	Wert
Bold	Lange Ganzzahl	1
Italic	Lange Ganzzahl	2
Plain	Lange Ganzzahl	0
Underline	Lange Ganzzahl	4

Im Parameter Icon können Sie ein Bild als Icon für den Eintrag übergeben. Sie können eine Referenz oder eine Bildbibliothek verwenden:

Referenz auf Bilddatei (Text): Sie müssen die Syntax path:<filesystem path> verwenden. Weitere Informationen dazu finden Sie im Abschnitt Filesystem Pfadnamen.
Bild aus Bildbibliothek: (Lange Ganzzahl oder Text, nur binäre Struktur): Sie können Name oder Nummer des Bildes übergeben. Die Verwendung von Nummern ist vorteilhafter, da Bildnummern einmalig sind. Dafür übergeben Sie Use PicRef+N im Parameter, wobei N die Referenznummer des Bildes in der Bildbibliothek ist. Use PicRef ist eine vordefinierte Konstante unter dem Thema Hierarchische Listen.
Übergeben Sie einen leeren String ("") oder Null (0) in Icon, wenn der Eintrag keine Grafik enthalten soll.

Hinweise:

Wir empfehlen, den Pfad zu einer Bilddatei zu verwenden, da die Bildbibliothek überholt ist und in einer Struktur im Projektmodus nicht unterstützt wird.
Wollen Sie 4D Bildausdrücke, wie Felder, Variablen o.ä. verwenden, um Icons für Einträge festzulegen, verwenden Sie den Befehl SET LIST ITEM ICON.

Mit dem optionalen Parameter Farbe können Sie die Farbe eines Eintragstexts verändern. Sie muss als RGB-Farbe angegeben werden, z.B. eine Lange Ganzzahl mit 4-Byte im Format 0x00RRGGBB. Weitere Informationen dazu finden Sie unter dem Befehl OBJECT SET RGB COLORS. Übergeben Sie -1 in Farbe, erscheint wieder die Orginalfarbe des Eintrags.

Beispiel 1

Siehe Beispiel zum Befehl APPEND TO LIST.

Beispiel 2

Das folgende Beispiel setzt den Schriftstil des aktuellen Eintrags von List in Fett und Hellrot.

SET LIST ITEM PROPERTIES(List;*;True;Bold;0;0x00FF0000)

Siehe auch

GET LIST ITEM PROPERTIES
Hierarchische Listen
SET LIST ITEM
SET LIST ITEM ICON