|
|
|
|
|
|
|
|
|
|
|
Version 11
GET LIST ITEM ICON ({*; }Liste; ZeileRef | *; Icon)
| Parameter | Typ | Beschreibung | |
| * | * |  | Mit * ist Liste ein Objektname (String) |
| Ohne * ist Liste eine Listenreferenznummer | |||
| Liste | ListeRef | String | | Mit *: Objektname der Liste |
| Ohne *: Referenznummer der Liste | |||
| ZeileRef | * | Lange Ganzzahl | * | | Referenznummerder Zeile oder |
| 0 für die zuletzt hinzugefügte Zeile oder | |||
| * für die aktuelle Zeile in der Liste | |||
| Icon | Bildvariable |  | Der Zeile zugeordnetes Icon |
Beschreibung
Der Befehl GET LIST ITEM ICON gibt im Parameter Icon das Icon zurück, das der Zeile zugeordnet ist, definiert durch den Parameter ZeileRef der Liste, definiert durch die Referenznummer oder den Objektnamen im Parameter Liste.
Ü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 (ListeRef).
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 aktuellen 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 Objektnamen der Liste und enthält das Formular mehrere Listen, zu denen dieser Name passt, wird GET LIST ITEM ICON auf das erste Objekt mit dem passenden Namen angewandt.
Sie können in ZeileRef eine Referenznummer übergeben. Entspricht diese Nummer keiner Zeile in der Liste, führt der Befehl nichts aus.
Sie können auch 0 (Null) in ZeileRef übergeben, um die zuletzt hinzugefügte Zeile (über APPEND TO LIST) in der Liste anzugeben.
Übergeben Sie * in ZeileRef, 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.
In Icon übergeben Sie eine Bildvariable. Sie enthält nach Ausführen des Befehls das der Zeile zugeordnete Icon, unabhängig von der zugrundeliegenden Quelle des Icons (statisches Bild, Ressource oder Bildaus-druck).
Ist der Zeile kein Icon zugeordnet, wird die Variable Icon leer zurückgegeben.
Hinweis: Wurde das einem Eintrag zugewiesene Icon über eine statische Referenz definiert (Ressourcenreferenz oder Bild aus der Bildbibliothek), lässt sich die Nummer über den Befehl GET LIST ITEM PROPERTIES herausfinden.
Referenz
GET LIST ITEM PROPERTIES, SET LIST ITEM ICON.
Hierarchical Lists in 4D v11 SQL
|
|
|
|
|
|
|
|
|
|
|