Attribut: conditionalshow
Das Pragma bewirkt, dass die Bezeichner einer eingebundenen kompilierten Bibliothek <library name> .compiled-library
, die mit dem Pragma ausgezeichnet wurden, vor Applikationsprogrammierern verborgen werden. Die Bausteine können aufgerufen werden, aber die Variablen sind in der CODESYS-Oberfläche unsichtbar.
Bibliotheksverwaltung
Debugging
Eingabehilfe
Feature "Komponenten auflisten“
Monitoring
Symbolkonfiguration
Das ist nützlich, wenn Sie Bibliotheken entwickeln. Als Bibliotheksentwickler zeichnen Sie Funktionsbausteine oder Variablen mit dem Pragma aus. Damit legen Sie fest, welche Bezeichner nach dem Einbinden in eine Applikation verborgen werden. Wenn Sie später die verborgenen Bezeichner beispielsweise beim Debugging oder beim Weiterentwickeln der Bibliothek vermissen, können Sie deren Sichtbarkeit wieder aktivieren.
Syntax
{attribute 'conditionalshow' := ' <some text> '}
Einfügeort: Oberste Zeile im Deklarationsteil eines Funktionsbausteins, oberhalb einer Variablen
Einfügeort | Erste Zeile über dem Deklarationsteil von Funktionen und Programmen |
| Optional Stringliteral, um die Sichtbarkeit der mit einem solchen Pragma gekennzeichneten Bezeichner mit einem Kommandozeilenbefehl und diesem Literal zu steuern Wenn das Pragma ohne Literal angegeben ist, sind die Variablen in der CODESYS-Entwicklungsumgebung immer verborgen, unabhängig davon, wie CODESYS gestartet wurde. TippWeitere Hilfe dazu finden Sie im Dokument „Library Development Summary“. |
Weitere Beispiele finden Sie im Dokument „Library Development Summary“.
Verbergen einer Variablen
FUNCTION_BLOCK FB_DataManager VAR {attribute 'conditionalshow' := 'Library_Developer'} iLocal : INT; iCounter : INT; END_VAR
Die Variable iLocal
ist unsichtbar.
Verbergen eines Funktionsbausteins
{attribute 'conditionalshow' := 'Library_Developer'} FUNCTION_BLOCK FB_DataManager VAR iLocal : INT; iCounter : INT; END_VAR
Die Bezeichner FB_DataManager
, iLocal
und iCounter
sind unsichtbar.
Sichtbarkeit bei vorhandener Quellcodedatei
Wenn von einer eingebundenen Bibliothek auch die Quellcodedatei <library name> .library
am gleichen Speicherort (Repository) vorhanden ist, sind die Bezeichnern trotz Pragmas sichtbar. Das ist unabhängig davon, ob in der Deklaration ein Attributwert angegeben wurde.
Kommandozeilenaufruf zur Aktivierung der Sichtbarkeit
Sie können die Sichtbarkeit der verborgenen Variablen auch ohne Quellcodedatei aktivieren, indem Sie CODESYS mit der Kommandozeilenoption conditionalshowsymbols
starten. Um die Sichtbarkeit zu aktivieren, geben Sie die durch Kommas voneinander getrennten Attributwerte der Pragmas an.
Syntax
codesys.exe --conditionalshowsymbols=" <some text> ( ,<next text> )* "
Für weitere Informationen siehe: Kommandozeilen-Schnittstelle verwenden
codesys.exe --conditionalshowsymbols="Library_Developer"
codesys.exe --conditionalshowsymbols="Group_A,Group_B"
Auswirkungen des Attributs auf Monitoring und intelligentes Kodieren
Aktion | Attribut gesetzt | Attribut nicht gesetzt | |
---|---|---|---|
Intelligentes Kodieren / Eingabehilfe | Methode | sichtbar | sichtbar |
Input | sichtbar | nicht sichtbar | |
Output | sichtbar | nicht sichtbar | |
Monitoring | Input | sichtbar | sichtbar |
Output | sichtbar | sichtbar | |
Local | sichtbar | sichtbar |
Aktion | Attribut gesetzt | Attribut nicht gesetzt | |
---|---|---|---|
Intelligentes Kodieren / Eingabehilfe | Methode | sichtbar | sichtbar |
Input | sichtbar | nicht sichtbar | |
Output | sichtbar | nicht sichtbar | |
Monitoring | Input | sichtbar | nicht sichtbar |
Output | sichtbar | nicht sichtbar | |
Local | sichtbar | nicht sichtbar |