Hiermit kann ein Listen-Element in das Anzeigefenster eingesetzt werden. Es sind auch spätere Zugriffe über Platzhalter möglich.
Der oben einzugebende Text enthält den oder die Einträge, die in die Liste hinzugefügt werden sollen (ein Eintrag pro Zeile).
Hier kann natürlich auch ein Platzhalter angegeben werden, der eine komplette Liste liefert, um das Element zu füllen, etwa [cX.Datei.Inhalt$(c:\*.*)].
Folgende Optionen stehen neben den Standardeigenschaften von Elementen zur Verfügung:
Text/Liste | Eine oder mehrere Textzeilen, die in die Liste eingetragen werden sollen. Ist die Option "Einträge mit IDs" aktiv, kann die Liste als ID=Text angegeben werden, wobei die IDs nicht angezeigt werden, aber über die Listeneintrags-Platzhalter auslesbar sind. |
Listentyp | Die Liste wird als einfache Liste, ausklappbare Dropdownliste, Kombinationsfeld (Eingabefeld und Dropdownliste) oder ankreuzbare Liste dargestellt, wobei die angegebene Höhe und die Option Mehrfachmarkierung bei Dropdownlisten ignoriert werden |
Einträge mit IDs | EX Diese Option ermöglicht die Verwaltung von Listeneinträgen, bei denen jedem Eintrag eine ID zugeordnet ist, z.B. die Artikelnummer, wenn in der Liste die Artikelnamen stehen. Die Einträge werden in diesem Fall als ID=Text-Paare eingetragen. Über Listenplatzhalter können dann neben dem Text auch die IDs ausgelesen werden. Hinweis: Bei Zugriff auf den aktuellen Eintrag (bzw. mehrere) über .Element.Wert bzw.die Datenbindung wird bei eingeschalteter Option immer die ID, ansonsten der Index der gewählten Zeile verwendet. |
Erst löschen | Die Liste wird zuerst geleert |
Mehrfachmarkierung | Es können mehrere Einträge der Liste markiert werden (nicht bei Dropdownlisten) |
Einfügeposition | Hier kann die Zeile angegeben werden, vor der der neue Text eingefügt werden soll |
keine Doppeleinträge | FG Mehrfach eingesetzte Texte werden unterdrückt, so dass keine doppelten Einträge vorkommen |
sortieren | Die vorhandenen Einträge in der Liste werden sortiert. Zur Auswahl stehen die Sortierung von Texten (alphanumerisch), Zahlen (numerisch) und Datumswerten, wahlweise auf- oder absteigend. |
entfernen | Der angegebene Eintrag wird aus der Liste entfernt |
markieren | markiert keinen oder alle Einträge (sofern Mehrfachmarkierung erlaubt und kein Eintrag zur Markierung angegeben ist) oder den letzten Eintrag |
auswählen | Der angegebene Eintrag wird markiert. Ist Mehrfachmarkierung aktiviert, können hier auch mehrere zu markierende Einträge angegeben werden, getrennt mit Semikolons. Der Index 0 markiert den zuletzt hinzugefügten Eintrag, -1 den letzten in der Liste. |
Tabs | FG hier können Tabulatorweiten mit ; getrennt angegeben werden (in Millimeter mit systembedingt geringer Präzision), auf denen mit ^T getrennte Einträge pro Zeile eingerückt werden |
Filter | FG Bestimmt eine Suchmaske, nach der beim Befüllen gefiltert wird (mit Wildcards, also ggf. "*such*"). Nicht zur Maske passende Einträge werden dann verworfen. |
Innenbreite | Innere Listenbreite (für den Inhalt): Ist diese breiter als die Liste selbst, wird ein horizontaler Schieber eingeblendet. Bei dem Wert -1 wird die Schieberbreite je nach Inhalt automatisch berechnet. Mit 0 wird der horizontale Schieber ausgeblendet |
Platzhalter:
Für Zugriffe auf das Element können neben den Standard-Platzhaltern für Elemente auch die Platzhalter aus [cX.Anzeige.Liste().X] (oder kurz [.Liste().X]) verwendet werden.
Einzelne Einträge werden über [cX.Anzeige.Liste().Eintrag().X] verwaltet.
Ereignisse:
Das Element löst die Standard-Ereignisse von Elementen sowie das _Check-Ereignis aus.
Hinweis: Durch Setzen des Platzhalters [.Liste().KeinRefresh] auf 1 vor der Befüllung etwa in einer Schleife wird die Aktualisierung der Liste unterdrückt, wodurch dies bei vielen Einträgen deutlich schneller abläuft. Nach dem Befüllen muss der Platzhalter wieder auf 0 gesetzt werden.
Beispielskript:
Anzeigefenster 'Fenster mit Liste' (zentriert, Aktivieren)
Anzeige-Liste 'Eintrag Nr.: 1¶Eintrag Nr.: 2¶Eintrag Nr.: 3¶Eintrag Nr.: 4¶Eintrag Nr.: 5¶' (ID='Testliste', zentriert, sortiert)
Warte endlos... |
Das Beispielskript legt eine Liste in einem Anzeigefenster an. Wenn Sie das Skript starten, erhalten Sie folgende Ausgabe auf dem Bildschirm:
cX-Webseite: http://www.clickexe.net