Systemvariablen

4D verwaltet Systemvariablen, mit denen Sie die Ausführung verschiedener Operationen steuern können. Alle Systemvariablen sind Prozessvariablen, auf die Sie nur innerhalb eines Prozesses zugreifen können. Im folgenden werden die Systemvariablen von 4D beschrieben.

Weitere Informationen dazu finden Sie im Abschnitt Richtlinien zur Typisierung.

Dies ist die gebräuchlichste Systemvariable. Sie hat den Wert 1, wenn die Operation erfolgreich ausgeführt wird, sonst den Wert 0 (Null). Viele 4D Befehle verändern den Wert der Systemvariablen OK. Ob dies der Fall ist, finden Sie in der Beschreibung der einzelnen Befehle.

In dieser Dokumentation zeigt das Pictogramm , dass der Befehl den Wert der Systemvariable OK ändert. Klicken Sie darauf, können Sie die Liste aller betroffenen Befehle generieren.

Document enthält den vollständigen Namen (Zugriffspfad+Name) oder den Namen der Datei, die zuletzt mit folgenden Befehlen geöffnet oder erstellt wurde:

FldDelimit enthält den ASCII Code, mit dem Felder beim Export oder Import voneinander getrennt werden. FldDelimit hat standardmäßig den Wert 9. Das ist der ASCII Code für die Tabulartortaste. Wollen Sie einen anderes Trennzeichen verwenden, weisen Sie FldDelimit einen neuen Wert zu.

RecDelimit enthält den ASCII Code, mit dem Datensätze beim Export oder Import voneinander getrennt werden. RecDelimit hat standardmäßig den Wert 13. Das ist der ASCII Code für die Zeilenschaltung. Wollen Sie ein anderes Trennzeichen verwenden, weisen Sie RecDelimit einen neuen Wert zu.

Diese Variablen sind nur in einer Methode verwendbar, die mit dem Befehl ON ERR CALL aufgerufen wurde. Sollen sie in der Methode verfügbar sein, die den Fehler verursacht hat, kopieren Sie den jeweiligen Wert in Ihre eigene Prozessvariable. 

• Error: Systemvariable vom Typ Lange Ganzzahl. Diese Variable enthält die Fehlernummer. Die Fehler von 4D sowie Systemfehler sind im Kapitel Fehlermeldungen aufgelistet.
• Error method: Systemvariable vom Typ Text. Diese Variable enthält den kompletten Namen der Methode, die den Fehler ausgelöst hat.
• Error line: Systemvariable vom Typ lange Ganzzahl. Diese Variable enthält die Zeilennummer, wo der Fehler in dieser Methode auftritt.
• Error formula: Systemvariable vom Typ Text. Diese Variable enthält die Formel des 4D Code (Volltext), wo der Fehler auftritt. Der Formeltext erscheint in der aktuellen Sprache des 4D Code.  
  Wird der für den Fehler verantwortliche Quellcode nicht gefunden, enthält Error formula einen leeren String. Das kann passieren, wenn:
  
  • Der Quellcode über den 4D Application Builder aus der kompilierten Struktur entfernt wurde.
  • Der Quellcode verfügbar ist, die Anwendung jedoch ohne die Option Range Checking kompiliert wurde.

Diese Systemvariablen lassen sich nur in einer Methode verwenden, die mit dem Befehl ON EVENT CALL aufgerufen wurde (außer MouseX und MouseY in einigen Fällen).

• MouseDown hat den Wert 1, wenn die Maustaste gedrückt wurde, sonst den Wert 0 (Null).
• Ist das Ereignis ein Mausklick (MouseDown=1), geben die Systemvariablen MouseX und MouseY die vertikale und horizontale Koordinate der Position des letzten Mausklicks an. Beide Werte werden in Pixel ausgedrückt und arbeiten mit dem lokalen Koordinatensystem des Fensters.
• Bei Klick auf ein Datenfeld vom Typ Bild oder Variable geben MouseX und MouseY die lokalen Koordinaten des Mausklicks in den Formularereignissen On Clicked oder On Double clicked bzw. in On Mouse Enter und On Mouse Move zurück. Die Koordinaten werden in Pixel angegeben, ausgehend von der oberen linken Ecke des Bildes (0,0). Weitere Informationen dazu finden Sie im Abschnitt Überblick über Bilder und unter dem Befehl SVG Find element ID by coordinates

• KeyCode ergibt den Zeichencode der zuletzt gedrückten Taste auf der Tastatur. Handelt es sich um eine Funktionstaste, ergibt KeyCode einen speziellen Code. Die Liste für Zeichencodes und Funktionstasten finden Sie im Abschnitt EXPORT TEXT.
• Modifiers hat nur einen sinnvollen Wert in einer Methode, die mit dem Befehl ON EVENT CALL aufgerufen wurde. Sie ergibt den Code für die jeweils gedrückte Sondertaste (Ctrl/Befehlstaste, Alt/Wahltaste, Umschalttaste, Feststelltaste).
• MouseProc gibt die Nummer des Prozesses an, in dem der letzte Mausklick ausgeführt wurde.