PxInclude Widget concepts

The PxInclude widget may have a single Px file associated with it, providing one include per widget, however, you can put more than one PxInclude widget in a Px file.

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 1. 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 2. PxInclude points to the file to be embedded


This example shows the inc1.pxfile embedded in another Px file. The embedded filename is visible in both the Properties window 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 3. Simple PxInclude markup in a parent Px file