If several displays use a common set of functions, variables or objects, it is possible to include the contents of another display (.rtv) file within those displays. Common elements, such as a navigation bar, can be defined and maintained in a separate display (.rtv) file and then included in each display.
To include a display file, select Tools>Include Files in the Display Builder. It is possible to include multiple display files within a single display. Displays can be nested, that is an included display file can include other files, however a display cannot include the same display (.rtv) file more than once.
Functions, variables and objects from an included display file cannot be modified in the current display, with the exception of the initial value of a variable. It is possible to copy objects from an included display file and paste them into your current display. Functions and variables associated with objects in an included display file can be used as data attachments by objects in the current display. However when a display file is removed from the Include Files list, all functions and variables associated with that file will be removed from the current display. Background properties (image, model properties, etc.) defined within an included display file are ignored and therefore not active in the current display.
If an included display file is in the same directory or subdirectory as the current display, a relative path to the included display file is saved in the current display (.rtv) file. If not, an absolute path to the included display file is saved.
Functions from an included display file are listed in the Functions dialog of the current display, but cannot be removed or modified. To edit an included function, you must directly edit the included display file. In the Edit Function dialog, the Include File field shows the name of the included function's display file.
An included function's result can be used in data attachments in the current display, however if the included display file is removed all associated functions will be removed from the current display.
Variables from an included display file are listed in the Variables dialog of the current display, but cannot be removed. However, the initial value of a variable from an included display file can be changed in the Variables dialog. For example, several displays may include a display file named Header.rtv in which a label object is attached to a variable named headerTitle. In the Variables dialog of the current display, the initial value of headerTitle (e.g.: Your Title Goes Here) can be changed (e.g.: My Display Title) and the new value will be saved in the current display (.rtv) file.
Properties of objects from an included display file are listed in the Object Properties window. The name of the included object's display file is noted in the objName property field. Included objects cannot be moved, deleted or modified in any way. To edit an included object, you must edit the included display file. It is also possible to copy objects from included displays and paste them into your current display.
If objects from an included display file have the same value for the objName property as objects in the current display, or other included displays, this may cause links to attach to the wrong object. To avoid this overlap, assign a unique value to the objName property of objects in files you intend to include in other displays.
In the Display Viewer, objects that are loaded from an included display file are treated exactly as objects that are loaded from the current display.