How to use Px Properties
A Px Property is a single, named data value that can be referenced by any widget on a Px page. Changing the value of a Px
Property instantly changes any widget that references it. Almost any widget property can be linked to and edited by a Px Property.
For the following example, you create three labels whose background properties are linked to a single Px Property, and demonstrate
how to use that Px Property to edit the background color of all the labels at once.
NOTE: This document uses the terms "Px Property" or "Px Properties" to refer specifically to Px Properties, and simply "property"
or "properties" to refer to the properties of a widget.
Perform the following steps:
- Open the Px Properties side bar.If the Px Properties side bar is not already visible in the Px Editor, you can open it by using the Side Bars icon (located on the main menu bar).
This side bar shows a listing of the names and values of all the Px Properties in your Px page, and allows you to add or remove them by clicking the Add or Remove button. - Adding a Px Property
- Click Add in the Px Properties side bar and enter alertBackground as the name and gx:Brush as the type.
Now your Px page has a Px Property namedalertBackground, visible in the Px Properties side bar. It initially has the default color for agx:Brush, which is black. - You edit Px Property values by clicking on them. Click on the value of the Px Property and set the value of the
alertBackgroundPx Property to red.
- Click Add in the Px Properties side bar and enter alertBackground as the name and gx:Brush as the type.
- Applying Px Properties to widgets
- Create three Labels with the text of your choosing.
- Right-click one of the labels, select Edit Properties to open the Properties dialog box, right-click the background property and choose .
Now, the background of this label is linked to thealertBackgroundPx Property and takes on its value. Note that its entry in the Properties dialog box is shaded green to indicate that its value comes from a Px Property.
- If you have many widgets to link, you can link them in batch as well. In this example, select both the second and third labels,
right-click and select Edit Properties. Again, right-click background and choose .
Now, the background of both labels are linked to thealertBackgroundPx Property and take on its value. - Now that all three Labels are linked to the
alertBackgroundPx Property, you can changealertBackground's value in the Px Properties side bar, and all three Labels will instantly receive the new value. Click the value (red) next toalertBackgroundand change it to another color of your choice (for example, lime).
The background of all three labels instantly changes.
- Create three Labels with the text of your choosing.