Inhaltsverzeichnis

cpGetStringVar

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 cpGetStringVar(Name:String);
Funktion Liest den Wert einer Package-Variablen vom Typ String aus
Typ String


Codebeispiel


Die Package-Variable mit dem Namen 'cpXpVersion'' enthält eine Zeichenfolge und soll abgefragt werden.

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.


Start - FAQ - Glossar - Sitemap - Impressum

 
cockpit-xp/addon/befehlsreferenz/cpgetstringvar.txt · Zuletzt geändert: 2020/11/28 12:15 (Externe Bearbeitung)