Das Pragma bewirkt, dass alle lokalen Variablen eines mit dem Pragma ausgezeichneten Bibliotheksbausteins vor Applikationsprogrammierern verborgen werden. Die Bausteine einer eingebundenen kompilierten Bibliothek ‎ <library name> .compiled-library‎ können aufgerufen werden, aber die Variablen sind in der CODESYS-Oberfläche unsichtbar.

Das ist nützlich, wenn Sie Bibliotheken entwickeln. Als Bibliotheksentwickler zeichnen Sie Funktionsbausteine mit dem Pragma aus. Damit legen Sie fest, dass deren Variablen nach dem Einbinden in eine Applikation verborgen werden. Wenn Sie später diese Bezeichner beispielsweise beim Debugging oder beim Weiterentwickeln der Bibliothek vermissen, können Sie deren Sichtbarkeit wieder aktivieren.

Syntax

‎{attribute 'conditionalshow_all_locals' ( := ' <some text> ' )? }‎

‎<some text>‎: Optionales 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. Weitere Hilfe dazu finden Sie im Dokument "Library Development Summary".

Einfügeort: Oberste Zeile im Deklarationsteil des Funktionsbausteins.

{attribute 'conditionalshow_all_locals' := 'Library_Developer'}
FUNCTION_BLOCK FB_DataManager
VAR
	iLocal : INT;
	iCounter : INT;
END_VAR

Sichtbarkeit bei vorhandener Quellcodedatei

Wenn von einer eingebundenen Bibliothek auch die Quellcodedatei ‎ <library name> .library‎ am gleichen Speicherort (Repository) vorhanden ist, sind die Bibliotheksbausteinvariablen 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.

codesys.exe --conditionalshowsymbols=" <some text> ( ,<next text> )* " 

codesys.exe --conditionalshowsymbols="Library_Developer"

codesys.exe --conditionalshowsymbols="Group_A,Group_B"