===== 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.\\

<Code:pascal linenums:1>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.</Code> 
\\
 Dieses Beispiel zeigt die folgende Meldung an.\\

{{ :cockpit-xp:addon:befehlsreferenz:addon-cpget-set-stringvar.png?nolink |}}

Achtung: Einige der globalen Variablen werden bereits von AddOns verwendet. Im Kapitel über die [[cockpit-xp:addon:schnittstelle|AddOn-Schnittstelle]] gibt es eine Liste mit den noch frei verfügbaren Nummern. \\
\\ 

----


[[cockpit-xp:start|Start]] - [[cockpit-xp:faq|FAQ]] - [[cockpit-xp:glossar|Glossar]] - [[cockpit-xp:sitemap|Sitemap]] - [[cockpit-xp:impressum|Impressum]]