FG Platzhalter für die Ermittlung bzw. Manipulation von Skriptparametern ([cX.Skript]):
Aktuelles Skript ([cX.Skript.X]):
.AktuellesEreignis | Ruft den Namen des aktuell aufgerufenen Ereignisses auf (nützlich in Sammelereignissen) |
.Build | Buildnummer des Skripts, falls es bereits kompiliert worden ist. |
.CmdPara(n) | Liefert den Kommandozeilen-Parameter mit dem angegebenen Index (1..n), wobei der erste Eintrag das gestartete Programm selbst ist. Die Parameter müssen mit Leerzeichen voneinander getrennt werden (z.B. /a /b).
Werden die Parameter in einer der üblichen Arten mit einem Namen versehen angegeben, etwa "/ID=Test" oder "-id:Test", kann hier als Index dieser Name angegeben werden (".CmdPara(ID)" liefert dann "Test").
Hinweis: Im cX-Editor wird nur die Kommandozeile aus den Skripteigenschaften verwendet. |
.CmdParas | Liefert die Anzahl der Parameter aus der Kommandozeile (Bei EXE einschließlich dem Programmpfad selbst). |
.cXBuild | click.EXE-Buildnummer |
.cXVersion | Versionsnummer der click.EXE-Version incl. Build, mit der das Skript gespeichert bzw. kompiliert wurde |
.cXVersionI | clickEXE-Version (Runtime) incl. Buildnummer als Ganzzahl |
.cXVersionL | clickEXE-Version (Runtime) als Ganzzahl (leichter zu vergleichen) |
.cXVersionR | clickEXE-Version (Runtime) mit Build |
.EreignisseVerarbeiten | Setzen auf leer bewirkt, dass alle anstehenden Ereignisse (etwa Benutzeraktionen) und Oberflächen-Aktualisierungen abgearbeitet werden.
Setzen auf 0 aktiviert den Exklusivmodus, 1 deaktiviert ihn wieder (siehe auch Fehler/Debug-Befehl). |
.EXEPfad | Liefert den Ordner der aktuellen EXE (Editor/Laufzeit-Modul/kompiliertes Skript) |
.FehlendePlugIns | Liefert eine Liste der im Skript verwendeten, aber nicht gefundenen PlugIns |
.ImEditor | Ergibt 1, wenn das Programm aus der Entwicklungsumgebung (mit Debugger) heraus gestartet wurde, 0 in EXE-Dateien. |
.Laufzeit | Liefert die Angabe des Zeitraums, über den das Skript bereits läuft. |
.LetztesElement | Liefert die ID des Elements, das zuletzt ein Ereignis ausgelöst hat (ggf. in Sammelereignis) |
.LetztesEreignis | Liefert den aktuell (ggf. in Sammelereignis) bearbeiteten Ereignisnamen (Name der Sprungmarke) |
.Lizenz | Liefert die aktuelle Lizenzstufe als Wert (0=Demo, 1=Test, 2=Standard, 3=Pro, 4=Premium) |
.LizenzBenutzer | Ruft den eingetragenen Namen in der aktuellen Lizenz ab |
.Lizenziert(Feature) | Liefert 1, wenn das angegebene Feature (z.B. ProFunctions) aktuell lizenziert ist. |
.LizenzName | Liefert die aktuelle Lizenzstufe als Text (Demo, Test, Standard, Pro, Premium) |
.Maßeinheiten | Zugriff auf die Einstellung, welche Maßeinheiten für Koordinaten und Größen verwendet werden sollen, wenn nicht anders spezifiziert (wie etwa bei "10pixel"): 0=Pixel, 1=Millimeter (Standard), 2=Zentimeter, 3=Zoll, 4=Twips |
.NichtBeenden | Setzen auf 1, um das Programmende beim Schließen des letzten Fensters zu verhindern (Setzen im 'Anzeige_Schließen'-Ereignis) |
.Pfad | Liefert den Pfad der Skript- bzw. EXE-Datei
Hinweis: Dies sollte nicht mit dem "aktuellen Arbeitsverzeichnis" verwechselt werden, welches in [cX.AktPfad] zu finden ist. |
.Plattform | Liefert die Plattform, in der das Skript ausgeführt wird:
1=Windows, 2=Windows-Konsole, 4=Windows-Dienst, 8=Linux-GUI, 16=Linux-Konsole, 32=Linux-Dienst |
.ProduktVersion | Ruft die Skriptversion (Produktversion) ab. |
.SchonDa | Ergibt 1, wenn das Programm bereits in einer anderen Instanz läuft. |
.Titel | Ruft den Skripttitel ab |
In der Pro-Version sind außerdem folgende Eigenschaften verfügbar:
.EreignisseVerarbeiten | Setzen auf leer bewirkt, dass einmal alle anstehenden Ereignisse (etwa Benutzeraktionen) und Oberflächen-Aktualisierungen abgearbeitet werden.
Setzen auf 0 aktiviert den Exklusivmodus, 1 deaktiviert ihn wieder (siehe auch Fehler/Debug: Exklusiv-Modus). |
.ID | Liefert eine eindeutige Zahl, die das ausgeführte Skript bzw. Programm identifiziert, etwa zur Unterscheidung verschiedener Instanzversionen eines Skripts in einer Netzwerkumgebung |
.Kultur | Liefert die Kurzform der im Skript eingestellten Sprache (z.B. "de") |
Die Premium-Lizenz bietet viele zusätzlichen Eigenschaften (siehe dort).
Zugriff auf Variablen eines aufrufenden Skriptes (siehe Objekte, cXtensionen und Externe Funktion):
Gekapselte Elemente wie Objekte werden in einem eigenen sogenannten Kontext ausgeführt. Hierdurch sind etwa Variablen oder Fenster unabhängig vom Hauptskript, d.h. es gibt normalerweise keine Zugriffe über diese Kontextgrenzen hinweg. Öffnet beispielsweise ein Objekt ein Fenster, kann auf dieses nicht aus dem Hauptskript zugegriffen werden (und umgekehrt). Dies gilt auch für Variablen etc..
Eine Ausnahme dabei ist der Zugriff auf Fenster aus dem Hauptskript, welcher immer noch möglich ist.
Um auf Variablen des Hauptskriptes zuzugreifen, kann in Objekten einer der folgenden Platzhalter verwendet werden:
cX.Hauptvariablen(X) | Zugriff auf die Variable X (anzugeben ohner eckige Klammern) des eigentlichen Hauptskriptes, von dem aus die Aufrufe initiiert wurden (es könnte ja ein Aufruf von einem seinerseits aufgerufenenen Makro- bzw. Objektskript erfolgt sein) |
cX.Muttervariablen(X) | Zugriff auf die Variable X des aufrufenden Skriptes. Werden Objekte geschachtelt, ist dieses nicht unbedingt das Hauptskript, sondern adressiert das aufrufende Skript, was ja selbst ein Objekt sein kann. |
System
Editor
Andere Platzhalter
cX-Webseite:
http://www.clickexe.net