Cross-reference dialog

Under Project > Open cross-reference list..., you can define for which variables the dependencies, locations of application, definitions and parameters are to be displayed in the cross-reference list using search and filter criteria.

In the left part of the dialog box you set the criteria for preselection and start the searching process with Search. Only those variables that fulfill all criteria are displayed in the left list field together with the definition location where they were first found.

In the right part of the dialog box the declarations and references (locations of application) for the variables selected on the left are displayed. This display can be further limited by filters. With Go to or by double-clicking the selected declaration or reference, you jump, for example, directly to the POU header or body in which the variable is declared or used.

For the search criteria of the preselection you can enter character strings with the following wildcard symbols:

Character	Meaning
*	All characters up to the current position are the same, i.e. characters after the * are ignored. If you enter Hug*, for example, all character strings will be found which start with “Hug”: “Hugo”, “Hug” or “HugoMeier” etc.
?	Any character is permissible at the current position. But there must be a character available at this position in the comparison character string. For example, if you enter Ba??, the character strings “Ball” and “Bach” will be found but not “Bau”.

For preselection you can define the following search criteria:

Search criterium	Possible values	Meaning
Identifier: “Name” declared for the variable in the “Identifier” field in the global variable list or in the POU header	<ALL> or *	All variables are taken into consideration.
	String	You can also enter a character string with wildcard characters here.
Declaration: Global variable list or all POU, task or DUT names available in the project	<ALL> or *	All declarations are searched for.
	<Unknown>	Only unknown declarations are taken into consideration (e.g. directly used addresses such as DT0 etc. have no declaration).
	POU name	Only variables in the selected POU are searched for.
	Project.GVL	Only variables in the global variable list of the project are searched for.
	Library_name.GVL	Only variables in the global variable list of the installed user library are searched for.
Type: All base or DUT data types (INT, BOOL, WORD etc.) used in the project, entities of a function block	<ALL> or *	Variables of all data types are taken into consideration.
	Data type	Only variables from the selected data type, e.g. INT, are taken into consideration.
	String	You can also enter a character string with wildcard characters here.
Address: All addresses defined in the project (IEC and FP format)	<ALL> or *	Variables of all addresses are taken into consideration.
	Address	Only variables with the selected IEC or FP address are taken into consideration.
	String	You can also enter a character string with wildcard characters here.
Class: In the global variable list or in the POU header for the declared variable class: VAR_GLOBAL, VAR_RETAIN etc.	<ALL> or *	Variables of all classes are taken into consideration.
	Class	Only variables of the selected class are taken into consideration.

After you have carried out preselection with Search, the variables found using the search criteria are displayed on the left. For each variable selected here, all declarations and references are displayed in the right-hand part of the dialog box under Declaration/Reference.

The display under Declaration/Reference can be limited even further using the following filter criteria.

Filter criterium	Settings	Meaning
Declaration: Global variable list or all POU, task or DUT names found	<ALL>	All declarations of the selected variables are displayed.
	<Unknown>	Only unknown declarations are displayed (e.g. directly used addresses such as DT0 etc. do not have a declaration).
	POU name	Only the declarations of the variables in the selected POU are displayed.
	Project.GVL	Only the declarations of the variables in the global variable list are displayed.
	Library_name.GVL	Only the declarations of the variables in the global variable list of the installed user library are displayed.
Access: Type of access to the selected variable: read and/or write access	<ALL>	All references of the variables are displayed.
	Read	Only the references from which the variable is read are displayed.
	Write	Only the references to which the variable is written are displayed.
	Read/Write	Only the references from which the variable is read and to which it is written are displayed.