Inhaltsverzeichnis
cpSetStringVar
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 | cpSetStringVar(Name:String); |
|---|---|
| Funktion | Weist einer Package-Variablen vom Typ String einen Wert zu |
| Typ | String |
Codebeispiel
Die Package-Variable mit dem Namen 'cpXpVersion'' erhält eine Zeichenfolge. Der Inhalt wird als Meldung ausgegeben.
var
message : String;
begin
// Package Variable initialisieren
cpSetStringVar('cpXpVersion', 'Cockpit-XP v3.0.3 build 319');
// Meldungstext erzeugen
message := 'Aktuelle Version: ' + cpGetStringVar('cpXpVersion');
// 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.
