Index | Prev | Next

Workflow for using the PxInclude Widget and ORD Variables

The PxInclude Widget provides a way for you to embed a single Px file in another Px file. The following is a general workflow for using the widget.
  1. Create (or open an existing) Px file that you want to use as an included or child Px file. This is the file that may be embedded in parent Px files using the PxInclude widget.
  2. Design the child Px file, as desired. If you are using any bound variables, consider whether or not to use an ORD variable for the ord property value of any bindings that you may want to assign only at the parent Px file level.
  3. Create any ORD variables using the $(var) syntax.
  4. Save the child Px file in the desired location.
  5. Create (or open an existing) parent Px file. This is the file that uses the PxInclude widget to embed the child Px file.
  6. Add a PxInclude widget to the parent Px file using one of the following methods:
    • Drag (cut and paste) the widget from a palette and edit the ord property to add the child Px file.
    • Drag (cut and paste) the child Px file from the workbench Nav tree to add the widget to the parent Px file with the child Px file already defined in the PxInclude ord property.
    • Drag (cut and paste) a component from the Nav tree to initiate the Make Widget Wizard. Use the Make Widget Wizard to select the child Px file and choose which variables to bind.
  7. Select the PxInclude widget and edit the following properties, as required:
    • enabled, layout, and visible - leave set to default values.
    • ord - click the value field and define or browser to select the child Px file. If you used the Make Widget wizard, this field may already be defined.
    • variables - click the value field to open the Variables dialog box. Use the editor field to define an ORD value for each variable that appears. Notice the After column to verify the correct ORD path for each variable.
  8. Click OK to close the Variables dialog box.
  9. Save the parent Px file and attach it as a view to a component, if desired.
  10. Verify that the variable ORD paths are set correctly by viewing the parent Px file from the component view (if used).

Related Links

  • Using a PxInclude Widget with a single ORD variable (an example)
  • Using PxInclude Widgets with multiple ORD variables (an example)
  • Common graphics tasks (Parent Topic)

    • Index | Prev | Next

    Copyright © 2000-2016 Tridium Inc. All rights reserved.