Befehl 'Querverweisliste'

Symbol _cds_icon_cross_references

Funktion: Der Befehl öffnet die Ansicht „Querverweisliste“.

Aufruf: Menü „Ansicht“, oder „Bearbeiten Symbol suchen Querverweise ausgeben“

Die Ansicht zeigt eine Liste der Querverweise im Projekt für ein Symbol. Das Symbol kann eine Variable, eine POU (Programm, Funktionsbaustein, Funktion) oder einen anwenderspezifischen Datentyp (DUT) sein. Dabei bietet die Querverweisliste grundsätzlich zwei Sucharten:

Textsuche: Durch die Eingabe eines Symbolnamens werden die Querverweise aller Symbole im Projekt mit diesem Namen angezeigt. Falls mehrere Symbole mit gleichem Namen gefunden werden, kann die Anzeige über das Kontextmenü auf einzelne Deklarationen eingeschränkt werden.
Deklarationssuche: Das Symbol kann über die Eingabehilfe oder durch die Eingabe eines qualifizierten Pfads (beispielsweise ‎Device.Application.PLC_PRG.i‎ oder ‎__POOL.POU.a‎) ausgewählt werden. Danach werden nur die Verwendungsstellen dieses Symbols angezeigt, auch wenn noch andere Symbole mit dem gleichen Namen existieren.

Eingabefeld	Symbolname (Variablenname, Bausteinname, DUT-Name). Eingabemöglichkeiten: Auswahl eines deklarierten Symbols über die Eingabehilfe, Schaltfläche . Händisches Eingeben des Symbolnamens. Auslösen der Suche über die Schaltfläche oder die [Eingabe]. Sie können für die Textsuche die Platzhalter "`‎‎`" (beliebig viele Zeichen) oder "`‎?‎`" (genau ein beliebiges Zeichen) in Kombination mit einer Teilzeichenkette eines Variablenbezeichners verwenden. Verwenden Sie "`‎%‎`" wenn Sie nach IEC-Adressen suchen wollen. Beispiele: "`‎%MW8‎`", "`‎%M‎`". Zusätzliche Möglichkeiten von außerhalb der Ansicht Querverweisliste: Verwenden des Befehls „Symbol suchen Querverweise ausgeben“, wenn der Name eines deklarierten Symbols in einem Editor selektiert ist oder der Cursor im Namen steht. Eine Suche ist auch möglich, wenn das Objekt im Gerätebaum oder POU-Pool selektiert ist. Automatisch, wenn der Name eines deklarierten Symbols in einem Editor selektiert ist oder der Cursor im Namen steht. Eine automatische Suche ist auch möglich, wenn das Objekt im Gerätebaum oder POU-Pool selektiert ist. Voraussetzung: CODESYS-Option „Querverweise automatisch bei Selektionsänderung aktualisieren“ ist aktiviert; Kategorie „Intelligentes Kodieren“. Folgende Eingaben sind gültig: Variablenname, einfach oder qualifiziert. Beispiele: "`‎iVar‎`", "`‎PLC_PRG.iVar‎`". Bausteinname: Beispiele: "`‎PLC_PRG‎`", "`‎myFB‎`". DUT-Name: Beispiel: "`‎mySTRUCT‎`". Zeichenfolgen in Kombination mit Platzhalter "" (beliebige Zeichen) oder "?" (genau ein beliebiges Zeichen). Beispiel: "`‎iVar‎`" betrifft `‎iVar1‎`, `‎iVar_glob2‎`, `‎iVar45‎` usw. "`‎iVar?‎`" betrifft `‎iVar1‎`, `‎iVar2‎`, `‎iVarX‎` usw., nicht aber `‎iVar_glob2‎`, `‎iVar45‎` usw. "`‎%<IEC-Adresse>‎`": CODESYS sucht nach Variablen, die dieser Adresse zugewiesen sind, und direkte Speicherzugriffe. Beispiel: "`‎%QB0‎`", `‎%Q0 := 2‎`.
	Eingabehilfe öffnen zur Auswahl eines Symbols
	Suche durchführen
	Spalten definieren, in denen nach der Zeichenfolge gesucht wird.
Eingabefeld	Zeichenfolge, nach der in den angewählten Spalten gesucht wird. Die Fundstellen werden gelb markiert. Querverweise ohne diese Zeichenfolge werden ausgeblendet.
	Quellposition des vorherigen Querverweises anzeigen, [Umschalt] + [F4]
	Quellposition des nächsten Querverweises anzeigen, [F4]
	Ergebnisse auf aktuelle Deklaration beschränken: Verfügbar, wenn für ein Symbol mehrere Deklarationen gefunden wurden. Begrenzt die Anzeige auf die Deklaration, die Sie gerade in der Liste selektiert haben.
	Quellposition des selektierten Querverweises anzeigen: Der Fokus springt zur Verwendungsstelle des Symbols.
	Querverweisliste drucken: Der Standarddialog zum Einrichten eines Druckauftrags erscheint.
Die gefundenen Querverweise werden mit folgenden Informationen dargestellt:
„Symbol“	Die Fundstellen für die Symbole (Variablen, POUs, DUTs) werden nach ihrer Deklaration gruppiert. Die Deklarationsstelle bildet den Wurzelknoten, darunter eingerückt erscheinen die Verwendungsstellen im Projekt. Dabei wird genau der Ausdruck angezeigt, den das Symbol an der Verwendungsstelle hat. Beispiel: Gibt es im Projekt eine globale Variable `‎i‎` und in einem Baustein eine lokal deklarierte Variable `‎i‎`, dann erscheinen nach einer Textsuche nach den Querverweisen zwei Wurzelknoten-Einträge in der Liste und darunter jeweils die Verwendungsstellen der Variable `‎i‎`.
„Baustein“	Bausteinname, DUT-Name; auch beispielsweise Taskname im Falle eines Bausteinaufrufs in der Taskkonfiguration.
„Variable“	Reiner Variablenname, beispielsweise `‎iVar‎`.
„Zugriff“	Art des Zugriffs auf die Variable an der Verwendungsstelle: „Deklaration“ / „Lesen“ / „Schreiben“ / „Aufruf“. Sonderfall für Pointer: Eine Zuweisung der Art `‎p := ADR(var1)‎` wird bei Suche nach `‎var1‎` als `‎Schreiben \| Adresse‎` angezeigt. Grund: Eventuelle Schreibzugriffe auf `‎p‎` werden bei Suche nach `‎var1‎` nicht angezeigt. Über die Pointervariable sind auch Schreibzugriffe möglich
„Typ“	Datentyp der Variablen.
„Adresse“	IEC-Adresse, falls der Variablen zugewiesen. Beispiel: "`‎AT %QB0‎`".
„Position“	Position der Verwendungsstelle innerhalb des Editors der betroffenen POU: beispielsweise Zeilennummer, Netzwerknummer, Deklarationsteil oder Implementierungsteil. Beispiel: "`‎Zeile 1, Spalte 1 (Impl)‎`".
„Objekt“	POU-Name + in eckigen Klammern der komplette Pfad der Verwendungsstelle, falls sich diese in der Ansicht „Geräte“ befindet. Beispiel: "`‎PLC_PRG [Device:Plc Logic:Application]‎`"
„Kommentar“	Kommentar, falls in der Deklaration der Variable vorhanden.

Die Suche liefert alle Fundstellen im Projekt sowie in eingehängten, nicht kompilierten Bibliotheken.

Befehle im Kontextmenü der Querverweisliste

„Quellposition anzeigen“: Öffnet den betroffenen Baustein und markiert die Verwendungsstelle: Für Root-Einträge die Deklaration, für darunter liegende Kindeinträge die jeweilige Verwendungsstelle. Alternativ können Sie auf eine Zeile doppelklicken.

„Ergebnisse auf ausgewählte Deklaration beschränken“: Grenzt im Fall von mehreren gefundenen Deklarationen die Anzeige der Ergebnisse auf die ausgewählte Symboldeklaration ein.

„Alles erweitern“: In der Liste erscheinen alle einzelnen Fundstellen.

„Alles reduzieren“: In der Liste erscheinen nur die Wurzelknoten aller Fundstellen.

Siehe auch