4D v14.3

SET LIST ITEM ICON

Home

 
4D v14.3
SET LIST ITEM ICON

SET LIST ITEM ICON 


 

SET LIST ITEM ICON ( {* ;} Liste ; EintragRef | * ; Icon ) 
Parameter Typ   Beschreibung
Operator in Mit * ist Liste ein Objektname (String)
Ohne * ist Liste eine Listenreferenznummer
Liste  ListRef, String in Mit *: Objektname der Liste
Ohne *: Referenznummer der Liste
EintragRef | *  Lange Ganzzahl, Operator in Referenznummer des Eintrags oder 0 für den zuletzt hinzugefügten Eintrag oder * für den aktuellen Eintrag in der Liste
Icon  Bild in Der Zeile zuzuordnendes Icon

Der Befehl SET LIST ITEM ICON ändert das Icon ändern, das der Zeile zugeordnet ist, definiert durch den Parameter EintragRef der Liste, definiert durch die Referenznummer oder den Objektnamen im Parameter Liste.

Hinweis: Sie können das einer Zeile zugeordnete Icon zwar auch mit dem Befehl SET LIST ITEM PROPERTIES verändern. Dieser erlaubt aber, im Gegensatz zu diesem neuen Befehl, nur statische Bildreferenzen. Das sind Referenzen auf Ressourcen oder Bilder aus der Bildbibliothek.

Übergeben Sie den ersten optionalen Parameter *, ist der Parameter Liste der Objektname (String) der Darstellung der 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 Syntaxarten 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.
Sie können in EintragRef eine Referenznummer übergeben. Entspricht diese Nummer keiner Zeile in der Liste, führt der Befehl nichts aus.
Sie können auch 0 (Null) übergeben, um die Schrift der zuletzt hinzugefügten Zeile (über APPEND TO LIST) in der Liste zu erhalten.
Übergeben Sie * in EintragRef, um die aktuelle Zeile der Liste anzugeben. Sind mehrere Zeilen manuell ausgewählt, ist die aktuelle Zeile die zuletzt ausgewählte Zeile. Ist keine Zeile ausgewählt, führt der Befehl nichts aus.
Im Parameter Icon übergeben Sie einen gültigen 4D Bildausdruck (Feld, Variable, Zeiger, etc.). Das Bild wird links vor der Zeile gesetzt.
Wir empfehlen besonders die Verwendung von Zeigern, da hierarchische Listen dafür optimiert sind: Im Speicher wird nur eine Instanz des Bildes angelegt, wenn dasselbe Icon für verschiedene Zeilen in der Liste verwendet wird.

Hinweis: Die direkte Verwendung für Variablen, die über die Befehle GET ICON RESOURCE oder GET PICTURE RESOURCE erstellt wurden, ist dagegen nicht empfehlenswert, da das Icon für jede Zeile in der Liste im Speicher dupliziert wird.

Dieser Code wurde durch Verwenden eines Zeigers optimiert:

 vIcon:=->[Params]Icon
 SET LIST ITEM ICON(mylist;ref1;vIcon->)
 SET LIST ITEM ICON(mylist;ref2;vIcon->)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Hierarchische Listen
Nummer: 950

 
GESCHICHTE 

Erstellt: 4D v11 SQL

 
SIEHE AUCH 

SET LIST ITEM PROPERTIES

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)