Skip to main content

Attribut: conditionalshow_all_locals

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 Basic Level-Oberfläche unsichtbar.

. Betroffene Features:

  • Bibliotheksverwaltung

  • Debugging

  • Eingabehilfe

  • Funktion “Komponenten auflisten“

  • Monitoring

  • Symbolkonfiguration

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.

Für weitere Informationen siehe: Dokumentation „Library Development Summary“

Syntax

{attribute 'conditionalshow_all_locals' := ' <some text> ' }

Einfügeort

Erste Zeile über dem Deklarationsteil des Funktionsbausteins

<some text>

Optional

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 Basic Level-Entwicklungsumgebung immer verborgen, unabhängig davon, wie Basic Levelgestartet wurde.

Verbergen aller lokale Variablen

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

Weitere Beispiele finden Sie im Dokument „Library Development Summary“.

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 Basic Level 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> )* "
Beispiel 260. Beispiel
codesys.exe --conditionalshowsymbols="Library_Developer"
codesys.exe --conditionalshowsymbols="Group_A,Group_B"


Für weitere Informationen siehe: hide_all_locals , conditionalshow und Kapitel „Visibility Control“

In diesem Abschnitt: