Skip to main content

Befehl: Querverweisliste

Symbol: _cds_icon_cross_references.png

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 über die Schaltfläche _cds_icon_crossref_symbol_from_input_assistant.png

  • Händisches Eingeben des Symbolnamens

    Auslösen der Suche über die Schaltfläche _cds_icon_show_next_location.png 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*

  • 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

_cds_icon_cross_reference_search.png

Eingabehilfe öffnen zur Auswahl eines Symbols

_cds_icon_go.png

Suche durchführen

_cds_icon_filter.png

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.

_cds_icon_crossref_source_pos_next.png

Quellposition des vorherigen Querverweises anzeigen, Umschalt + F4

_cds_icon_crossref_source_pos_previous.png

Quellposition des nächsten Querverweises anzeigen, F4

_cds_icon_limit_to_declaration.png

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

_cds_icon_crossref_go_to_source_position.png

Quellposition des selektierten Querverweises anzeigen

Der Fokus springt zur Verwendungsstelle des Symbols.

cds_icon_cross_ref_print.png

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

Beispiel: 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.

Für weitere Informationen siehe: Verwendungsstellen mit der Querverweisliste finden