Attribut 'conditionalshow'

Das Pragma ist relevant für Funktionsbausteine und weitere Typen, die in einer Bibliothek enthalten sind.

Das Pragma bewirkt, dass die Bezeichner einer eingebundenen Bibliothek vom Typ *.compiled-library, die mit dem Pragma ausgezeichnet wurden, verborgen werden. Die Bausteine oder Variablen werden dann in der Benutzeroberfläche nicht angezeigt. Wenn die eingebundene Bibliothek als *.library installiert ist, sind die Bezeichner trotz des Pragmas in der Benutzeroberfläche sichtbar.

Betroffene Features:

Bibliotheksverwaltung
Debugging
Eingabehilfe
Funktion 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 ein Projekt 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'}

Einfügeort: Zeile oberhalb einer Signatur

Beispiele

Verbergen einer Variablen:

FUNCTION_BLOCK FB_Sample
PROGRAM_MAIN
VAR
    {attribute 'conditionalshow'}
    nLocal    : INT;
    nCounter  : INT;
END_VAR

Die Variable nLocal ist unsichtbar.

Verbergen eines Funktionsbausteins:

{attribute 'conditionalshow'}
FUNCTION_BLOCK FB_ Sample
VAR
    nLocal    : INT;
    nCounter  : INT;
END_VAR

Die Funktionsbaustein FB_Sample ist unsichtbar.

Auswirkungen des Attributs auf Monitoring und intelligentes Kodieren

(bei Einfügen des Attributs jeweils über der Deklaration der Bezeichner)

*.library (Source-Bibliothek)

		Attribut gesetzt	Attribut nicht gesetzt
Intelligentes Kodieren/ Eingabehilfe	Funktionsbaustein	sichtbar	sichtbar
	Methode	sichtbar	sichtbar
	Input	nicht sichtbar	sichtbar
	Output	nicht sichtbar	sichtbar
	Local	sichtbar	sichtbar
Monitoring	Input	sichtbar	sichtbar
	Output	sichtbar	sichtbar
	Local	sichtbar	sichtbar

*.compiled-library (übersetzte Bibliothek)

		Attribut gesetzt	Attribut nicht gesetzt
Intelligentes Kodieren/ Eingabehilfe	Funktionsbaustein	nicht sichtbar	sichtbar
	Methode	nicht sichtbar	sichtbar
	Input	nicht sichtbar	sichtbar
	Output	nicht sichtbar	sichtbar
	Local	nicht sichtbar	sichtbar
Monitoring	Input	nicht sichtbar	sichtbar
	Output	nicht sichtbar	sichtbar
	Local	nicht sichtbar	sichtbar

Wenn von einer eingebundenen Bibliothek am gleichen Speicherort (Repository) die Quellcodedatei *.library vorhanden ist, sind die Bezeichner trotz des Pragmas sichtbar.

Siehe auch: