Inhaltsverzeichnis
cpGetStringVarG
Cockpit-XP unterscheidet zwischen mehreren Arten von Variablen.
- Lokale Variable
- Package Variable
- Globale Variable
Die lokale Variable ist nur innerhalb des Events gültig und nutzbar, in dem sie definiert ist.
Package Variablen können innerhalb desselben AddOns in jedem Event verarbeitet werden.
Namen von lokalen und Package-Variablen sind frei wählbar. Es ist jedoch empfohlen, keine Namen zu verwenden, die mit Befehlen verwechselt werden können.
Globale Variablen sind auch in anderen AddOns verwendbar, die zur gleichen Zeit aktiv sind. Sie sind im Befehl mit einem G gekennzeichnet. Anders als bei lokalen und Package-Variablen ist der Name IMMER ein Integer Wert! Somit stehen 2.147.483.647 mögliche Variablen zur Verfügung. Das sollte für die meisten AddOns ausreichend dimensioniert sein.
Syntax
| Befehl | cpGetStringVarG(Number:Integer); |
|---|---|
| Funktion | Liest den Wert einer globalen Variablen vom Typ String aus |
| Typ | String |
Codebeispiel
Die globale Variable mit der Nummer 100 enthält eine Zeichenfolge und soll abgefragt werden.
var message : String; begin // Globale Variable Nr. 100 initialisieren cpSetStringVarG(100, 'Cockpit-XP v3.0.3 build 319'); // Meldungstext erzeugen message := 'Aktuelle Version: ' + cpGetStringVarG(100); // Meldung anzeigen cpShowMessage(message); end.
Dieses Beispiel zeigt die folgende Meldung an.
Achtung: Einige der globalen Variablen werden bereits von AddOns verwendet. Im Kapitel über die AddOn-Schnittstelle gibt es eine Liste mit den noch frei verfügbaren Nummern.
