CROSS REFERENCES Window
The CROSS REFERENCES window, located in the Cross Function Area at the lower screen border, lists all cross references in your project. For example, the use and declaration of all variable types (including user-defined STRUCTs), instance declaration and call of function blocks, jump labels, SFC elements (transition/action/step names) are listed, as well as HMI tags, and much more. Connectors are not listed.
Collecting the cross references must be started manually by clicking the 'Collect' icon shown below. The cross references are then displayed in the form of a table.
Toolbar in the CROSS REFERENCES window
 | Indicates the status of the collected cross references. The green symbol means that the cross references are up-to-date. After modifying the project (e.g., by creating a POU or editing any worksheet), the warning symbol indicates to possibly outdated cross references. Click the 'Collect' icon to update the list (see next table row). |
 | Collects the cross references from all worksheets and editors. You can sort and filter the list. |
 | Clears the list and removes all entries. |
Having collected the cross references, double-clicking a table entry directly jumps into the corresponding editor or data list.
Example: Double-click to jump into code or variable table.
Showing cross references out of the code or variables table/Data List
The cross references of a variable/FB instance variable can also be displayed and reached via its context menu
- in code worksheets
- in variables tables
- in Data Lists
The following commands are available in the context menu at each of these locations:
Note
These commands are only active in the context menu, if the list of cross references is collected and up-to-date ( icon is shown in the CROSS REFERENCES window). If the commands are inactive, collect the cross references by clicking the following symbol on the CROSS REFERENCES toolbar:
 |
Context menu item | Shortcut | Meaning |
Cross References | - | Shows all references of the current object except the currently selected occurrence. Selecting a submenu entry directly jumps into the corresponding editor or data list ("jump-to functionality" like in the CROSS REFERENCES window). |
Locate in Cross References | <Ctrl>+<,> | Opens the CROSS REFERENCES window and marks the respective entry for this variable. |
Show all References | - | Like 'Locate in Cross References' (prev. table row), this command opens the CROSS REFERENCES window and marks the respective entry for this variable. In addition, the cross reference list is automatically filtered for occurrences with the same 'Name', 'Type' and 'Kind'. For local variables, the POU name is used as filter criterion too.For arrays, only members with the same index are shown. Accordingly, for structures only members with the same name are shown.If filters are already set when executing the command, they are cleared. You can then set 'Access' and 'Kind' filters again to apply them in combination with the automatically set filters. Selecting a new text filter, however, clears the automatically set filter criterions.By clicking the delete icon on the right of the 'Search' input field, the filters are reset. |
Filtering/Sorting the cross references
Filter the cross references list
The table can be filtered with predefined filters or by text. In the table header, an active filter is indicated by the
icon in the first column. The filter criteria (predefined filter and search text) act additive.
- Filtering with predefined filters: Left-click the filter icon at the top right above the table. Then activate/deactivate the desired filter(s).
The activated filter is indicated by the framed filter icon.
To deactivate the filter, click the filter icon again and deactivate the checked filter options.
- Filtering by text: Enter the search text into the 'Search' input field. The search operates on all visible texts in the table except the group names.
Deactivate the search by clicking the delete icon
on the right of the 'Search' input field.
Note
When executing 'Show all References' from the context menu of a variable, the filter rules apply as described in the table above. |
Sort the cross references list
The table can be sorted alphabetically in ascending, descending or unsorted order where each column can be used as sort criterion. To sort the table by the column data, left-click on the column title field (an arrow up/down icon above the column name shows the sort order). To toggle through the sort order, click the column title field again.