Für Listen-Elemente (s.u.) gelten neben den normalen Elemente-Platzhaltern auch spezielle, welche über [cX.Anzeige.Liste(ID).X] (oder [.Liste(ID).X]) erreicht werden.
Listen-Elemente sind alle Anzeige-Elemente, in denen Unterelemente enthalten sind:
Liste (auch Dropdown-Liste)
Listenansicht (Spalten und Zeilen) - siehe auch .Listenansicht.X-Platzhalter)
Optionsschalter-Gruppen oder
Schalter-Gruppen (hier wird jeweils eine der Schalter-IDs angegeben)
Für X kann dann stehen:
.Abgehakte | Liefert/Setzt eine Index-Liste der abgehakten Elemente in der Liste mit Checkhäkchen (etwa Listenansicht oder Baum). Beim Baum wird in der obersten Ebene bzw. unter dem angegebenen Zweig gesucht. |
.AbgehakteIDs | Liefert die IDs bzw. Namen der abgehakten Elemente in der Liste mit Checkhäkchen (etwa Listenansicht oder Baum) bzw. setzt die Markierungen anhand der angegebenen IDs. |
.AktuellerEintrag | Liefert den Namen des (ersten) gewählen Untereintrags des Listenelements (bzw. der Schalter-/Optionengruppe), falls verfügbar. |
.Anzahl | ergibt die Anzahl der Einträge in der Liste |
.AuswahlVerbergen | Legt fest, ob die Markierung von Elementen bei Fokusbverlust verborgen werden soll (Listenansicht, Baum) |
.Entfernen | setzen auf eine ID oder einen Index löscht den Eintrag mit dem Index; Setzen auf Nichts löscht den aktuellen Eintrag (falls definiert) Um bei Listenansicht-Elementen eine Spalte zu entfernen, kann [.Listenansicht.SpalteEntfernen] verwendet werden. |
.Hinzufügen(X) | Fügt dem Element Einträge hinzu (Format siehe "Einträge"-Eigenschaft des jeweiligen Elements, etwa Text;ID;Bild;... bei Listenansicht oder Baum) Als Index kann der Listenindex angegeben werden, an dem die Einträge eingefügt werden sollen (ohne Index wird angehängt). Der Index -1 verwendet den aktuellen Eintrag. Optional kann bei Listenansicht-Elementen als Index -2;Index angegeben werden, um eine Spalte hinzuzufügen. Beim Baum kann die Adresse des Knotens angegeben werden, in den die neuen Einträge eingesetzt werden sollen. Wird als 3. Parameter eine 1 angegeben, wird der neue Eintrag in der Liste aktiviert. |
.KeinRefresh | Setzen auf einen Wert ungleich 0 unterdrückt jede Aktualisierung in dem Listenelement, 0 gibt es wieder frei und zeichnet neu. Nur gültig bei Liste, Listenansicht und Baum. Hinweis: Diese Unterdrückung muss unbedingt wieder aufgehoben werden (0). |
.Leeren | Leert die angegebene Liste |
.Liste | liefert/setzt den gesamten Inhalt der Liste (optional .Liste$) als Zeilenumbruch-getrennte Liste |
.Liste(Typ) | liefert/setzt den Listeninhalt des Elements. Beim Lesen kann als Index bestimmt werden, ob eine Liste der IDs (1) oder ID=Text-Paaren (2) geliefert werden soll. Im Falle von Listenansicht-Elementen kann eine Liste der Spalten mit Texten (4), IDs (5), Text;ID (6) oder ID=Text-Paaren (7) angefordert werden. Ankreuz-Listen liefern nur die angekreuzten Elemente. Bei einer Listenansicht gibt es noch den Typ 8=Tabelle. Gesetzt wird bei Listenansicht, Baum, Status- oder Symbolleiste eine Liste mit Einträgen in der Form "Text;(ID);(Bild);(Tooltip)" (Werte in Klammern sind optional), wobei je nach Typ ggf. auch weitere Angaben gemacht werden können (siehe beim jeweiligen Element). |
.ListenText(X) | Setzen neuer Einträge wie .Zeile, wobei hier keine Attribute berücksichtigt werden (auch Texteinträge mit ; möglich) |
.Markiert | liefert/setzt den Index der (ersten) markierten Zeile (0=Nichts markiert) |
.Markierte | liefert den Index der markierten Zeile bzw. eine Liste der markierten Einträge (bei Mehrfachauswahl) |
.MarkierteID | liefert die ID der (ersten) markierten Zeile |
.MarkierteIDs | Liefert die IDs bzw. die Namen aller markierten Einträge (etwa bei Liste mit Mehrfachauswahl, Listenansicht, Schaltergruppe) |
.MarkierterText | Liefert den Text des (ersten) markierten Eintrags |
.Pfad | Liefert beim Baum den kompletten Pfad (Hauptknoten-ID\Unterknoten-ID\Knoten-ID) des aktuell gewählten Baumelements |
.Standardsymbol | Ist beim Hinzufügen von neuen Einträgen kein Symbol angegeben, wird dieses verwendet (kein Symbol: %% angeben). Nur bei Listenansicht und Baum. |
.Suche(X) | Liefert den Index des Unterelements zurück, dessen Text der Suchmaske entspricht (Wildcards wie *such* möglich). Das Ergebnis bleibt leer, wenn der Begriff nicht gefunden wurde. Optional kann mit Maske;n auch der Startindex n für die Suche angegeben werden. |
.SucheID(X) | liefert den Listenindex des Eintrags mit einer zum Suchbegriff X passenden ID |
.Verschiebe | Setzen auf die Indices "von;nach" verschiebt den Listeneintrag von vor den Eintrag nach.. Hinweis: Eine eventuelle Sortierung wird dabei abgeschaltet. |
.Zeile(Index) | Zugriff auf eine ganze Zeile. Als Index kann die Zeilennummer, -1 für die markierte Zeile oder die ID angegeben werden. Wahlweise kann bei einigen Elementen (z.B. Listenansicht in Detailansicht) auch die Spaltennummer angegeben werden, wo Zeile 0 für die Spaltenüberschrift steht. |
.ZeilenMarkierung | Listenansicht: In der Detailansicht die ganze aktuelle Zeile markieren Baum: Ganze Zeile markieren |
Speziell für Listenansicht-Elemente gelten zudem noch folgende Platzhalter (siehe auch Listenansicht-Platzhalter):
.LVSpaltenFilter | Setzen auf Spalte;Maske filtert (temporär) nach den Zeilen, in denen der Text in der angegebenen Spalte der Maske entspricht (mit Wildcards). Setzen auf Leer setzt den Filter zurück, ebenso das Ändern des Listeninhalts. Da die Filterung temporär ist, muss die Liste nicht immer neu gefüllt werden, sondern der Gesamtinhalt bleibt bis zur Rücksetzung im Speicher. (siehe auch Listen-Ansicht, Eigenschaft "Filter") Als Spalte kann der Spaltenindex oder dessen Name oder Text angegeben werden. Die Maske kann ein Text mit Wildcards oder eine Bedingung <X bzw. >X sein (berücksichtigt Spaltentyp, also kleiner/größer als der Text/der Wert/das Datum X) Wird ?? vor den Ausdruck gesetzt, wird dieser per RegEx ausgewertet (Regular Expression), z.B. ??n$ für "endet auf n" (siehe auch Text bearbeiten). |
Über die Unterplatzhalter .Liste.Eintrag().X und .Liste.Zweig().X kann direkt auf Eigenschaften von Listeneinträgen zugegriffen werden.
cX-Webseite: http://www.clickexe.net