PxInclude Widget concepts
Depending on the design of a Px file, a single "parent" Px file may contain many "child" Px files by using many PxInclude widgets.
The following diagram illustrates the basic concept of embedding one Px file in one or more other Px files.
Figure 38. PxInclude Concept Diagram
Note the following about the Px files represented in this diagram:
- Px files X, Y, and Z are included in other Px files
- Px files X, Y, and Z may display as independent views, as well as be embedded using the PxInclude widget.
- Px file Y is included in both Px file A and Px file B.
- Changes to files X, Y, or Z are displayed in their parent Px files (A or B), via the PxInclude, when the parent view is refreshed.
PxIncludes work by defining an ord property value that points to the "included" file, as shown in the following illustration.
Figure 39. PxInclude points to the file to be embedded
This example shows the "inc1.px" file embedded in another Px file. The embedded filename is visible in both the Properties dialog box and in the Widget Tree.
When PxIncludes are added to a Px file, the "include" markup appears as follows in the Px code (visible in the "Text File Editor" view).
Figure 40. Simple PxInclude markup in a parent Px file
