Skip to main content

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.

. Betroffene Features
  • 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

<some text>

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.

Tipp

Weitere Hilfe dazu finden Sie im Dokument „Library Development Summary“.

Beispiel 259. Beispiel

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

Tabelle 23. Quellbibliothek:

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



Tabelle 24. Übersetzte Bibliothek

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