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.

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> ' )? }‎

‎<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 eines Funktionsbausteins, oberhalb einer Variablen

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

{attribute 'conditionalshow' := '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 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.

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

codesys.exe --conditionalshowsymbols="Library_Developer"

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