Befehl Variable deklarieren

Funktion: Der Befehl öffnet den Dialog Variable deklarieren, der die Deklaration einer Variablen unterstützt.

Aufruf: Menü Bearbeiten, Kontextmenü Editorfenster

Voraussetzung: Eine POU ist im Editor geöffnet und der Cursor steht in einer Programmzeile.

Durch die Autodeklarationsfunktion erscheint der Dialog Variable deklarieren auch, wenn der Cursor im Implementierungsteil einer POU in einer Zeile steht, die den Namen einer nicht deklarierten Variablen enthält. Als Voraussetzung hierfür müssen Sie in den TwinCAT‑Optionen die Option Unbekannte Variablen automatisch deklarieren (AutoDeclare) aktiviert haben (Extras > Optionen > TwinCAT > SPS Programmierumgebung > Intelligentes Kodieren).

Durch die Smart-Tag-Funktion erscheint der Befehl Variable deklarieren auch, wenn Sie im Implementierungsteil des ST-Editors den Cursor auf eine Variable setzen, die nicht deklariert wurde, und anschließend auf Befehl Variable deklarieren 1: klicken (verfügbar ab Build 4026).

Dialog Variable deklarieren

Gültigkeitsbereich	Gültigkeitsbereich der noch nicht deklarierten Variablen. Beispiel: `VAR` (Standardeinstellung bei lokaler Variable)
Name	Noch nicht deklarierter Variablenname Beispiel: `bVar`
Datentyp	: Listet die Standarddatentypen auf. : Eingabehilfe: Öffnet den Dialog Eingabehilfe Array-Assistent: Öffnet den Dialog Array Beispiel: `BOOL`
Objekt	Objekt, in dem die neue Variable deklariert wird. Standardmäßig steht hier das Objekt, das Sie gerade bearbeiten. : Listet die Objekte auf, in denen die Variable deklariert werden kann. Wenn für den ausgewählten Gültigkeitsbereich keine Objekte verfügbar sind, erscheint der Eintrag <Objekt anlegen>. Wenn Sie den Eintrag <Objekt anlegen> auswählen, öffnet sich der Dialog Objekt hinzufügen zur Erzeugung eines geeigneten Objekts.
Initialisierungswert	Wenn Sie keinen Initialisierungswert eingeben, wird die Variable automatisch initialisiert. : Öffnet den Dialog Initialisierungswert. Diese Vorgehensweise ist für die Initialisierung von strukturierten Variablen hilfreich. Beispiel: `FALSE`
Adresse	Speicheradresse (siehe Dokumentation PLC: Adressen) Beispiel: %IX1.0
Flags	Attribut-Schlüsselwörter CONSTANT: Schlüsselwort für eine Konstante RETAIN: Schlüsselwort für eine remanente Variable PERSISTENT: Schüsselwort für eine persistente Variable (strenger als RETAIN) Das ausgewählte Attribut-Schlüsselwort wird der Variablendeklaration hinzugefügt.
Kommentar	Im tabellarischen Deklarationseditor erfolgt die Anzeige des eingegebenen Kommentars in der Spalte Kommentar, im textuellen Deklarationseditor oberhalb der Variablendeklaration. Beispiel: `New variable`
Änderungen mit Hilfe von Refactoring anwenden	Die Option erscheint bei folgenden Gültigkeitsbereichen: Eingabevariable (VAR_INPUT) Ausgabevariable (VAR_OUTPUT) Ein- und Ausgabevariable (VAR_IN_OUT) Die Option ist automatisch aktiviert, wenn in den TwinCAT-Optionen die Autodeklaration‑Optionen Beim Umbenennen von Variablen und Für das Hinzufügen oder Entfernen von Variablen, oder für das Ändern des Namensraums aktiviert sind (Extras > Optionen > TwinCAT > SPS Programmierumgebung > Refactoring) (siehe Dialog Optionen - Refactoring). Wenn die Option aktiviert ist, wird die Variable beim Beenden des Dialogs noch nicht deklariert, sondern es öffnet sich zunächst der Dialog Refactoring, in dem Sie die Änderungen weiter bearbeiten können.
OK	Die Variable wird deklariert und erscheint in der Deklaration. Beispiel: VAR // New variable bVar: BOOL := FALSE; END_VAR

Siehe auch:

Dokumentation PLC: Variablen deklarieren

Dialog Array

Dimensions- und Basistyp-Angabe	Definition der Feldgrößen (Dimension) durch Eingeben der unteren und oberen Grenzen und des Basistyps des Arrays. Den Basistyp können Sie direkt eingeben oder mithilfe der Dialoge Eingabehilfe oder Array, wenn Sie die Schaltfläche anklicken.
Ergebnis	Anzeige des definierten Arrays.

	TwinCAT initialisiert Variablen nur neu, wenn Sie die Initialisierungswerte der Variablen geändert haben.

Dialog Initialisierungswert

Auflistung der Variablen mit Namen (Ausdruck), Initialisierungswert und Datentyp. Geänderte Initialisierungswerte werden fett dargestellt.
Eingabefeld unterhalb der Liste	Eingabe eines Initialisierungswerts für die selektierte Variable(n).
Wert auf ausgewählte Zeilen anwenden	Änderung des Initialisierungswerts der selektierten Zeile(n) entsprechend dem Wert des Eingabefelds.
Ausgewählte Zeilen auf Standardwerte zurücksetzen	Herstellung der Standard-Initialisierungswerte.
OK	TwinCAT übernimmt die Initialisierungswerte in den Dialog Variable deklarieren.

Falls die über diesen Dialog zu initialisierende Variable eine Funktionsbaustein-Instanz mit erweiterter FB_Init-Methode ist, wird oberhalb der Tabelle Initialisierungswert eine weitere Tabelle angezeigt (siehe Dokumentation PLC: Methoden FB_init, FB_reinit und FB_exit). In dieser Tabelle werden die zusätzlichen FB_Init-Parameter aufgelistet. Die Bedeutung und Bedienung entspricht im Wesentlichen der unteren Tabelle mit folgenden Unterschieden:

Es müssen alle Variablen mit Initialisierungswerten belegt sein. Ansonsten ist OK nicht anwählbar.
Bei komplexen Datentypen (Strukturen, Arrays) werden keine darin enthaltenen Komponenten angezeigt (Typ kann nicht aufgeklappt werden). In diesem Fall muss der komplexe Typ mit einer entsprechenden Variable initialisiert werden.

Bei so konfigurierten FB_Init-Parametern wird im Dialog Variable deklarieren ein entsprechendes Symbol hinter dem Initialisierungswert angezeigt.

Siehe auch:

Dokumentation PLC: Eingabeunterstützung nutzen