Listen-Platzhalter

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)

Baum

Symbolleiste

Statuszeile

Optionsschalter-Gruppen oder

Schalter-Gruppen (hier wird jeweils eine der Schalter-IDs angegeben)

Menü

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)

Über die Unterplatzhalter .Liste.Eintrag().X und .Liste.Zweig().X kann direkt auf Eigenschaften von Listeneinträgen zugegriffen werden.

Schrift

cX-Webseite: http://www.clickexe.net