You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.


Property bindings are important when designing projects in Perspective. Each Perspective component has a number of properties that change the way a component looks and behaves, but it's through property bindings that bring your Perspective sessions to life to accomplish useful things.

A property binding is the simplest type of binding. It's a way of linking one component property in a view to another component's property in the same view. Not only can you link one property in a view to another property in the same view, but you can also link a component to a property within a UDT, and pass a property into an embedded view through a view parameter.

This page describes how to set up property bindings for properties in the same view, bind to a property within a UDT, and how to use a view parameter to pass a property into an embedded view. 

Using Property Bindings Across Views

You cannot have a binding refer to a property in another view instance even view instances that may be embedded in a view. You can pass a property into an embedded view through a view parameter.


On this page ...

IULocgo


Property Binding

Property to Property Binding

A property binding simply binds one component's property to another. When that property changes, the new value is pushed into the property that the binding is setup on. In this example, we'll use a Tank, LED Display, and Slider components. We'll bind the 'value' properties of the Tank and LED Display to the 'value' property of the Slider in the same view so whenever the value of the Slider changes, the Tank and LED Display will reflect the same value.

  1. In the Designer, create a view.
  2. From the Component Palette, drag Cylindrical Tank, LED Display, and Slider components into your Designer workspace. 
  3. Select the Tank. In the Property Editor, click on the Binding  icon for the 'value' property.



  4. This opens the Edit Binding window. Configure the following settings:
    1. Select the Property binding type.
    2. Under Configure Property Binding, click the Insert Propertyicon to open the Property popup box. Expand the folders and select the Slider 'value' property. Click OK.
    3. Click OK to save the binding settings.

  5. Select the LED Display. In the Property Editor, click on the Binding  icon for the 'value' property and repeat Step 4.
  6. To see the labels on the Slider, select the Slider and set the show property to 'true'.
  7. Save your project. Put the Designer in Preview Mode .
  8. Move the slider and you'll see both the tank level and LED display change to the value of the Slider. 


Pass a Property into an Embedded View Using a View Parameter

The only way to a pass a property across views is by passing a view parameter into an embedded view. You have options on how to pass a property into an embedded view, how you decide to set up passing a parameter depends on how you design your project. You can set up passing a property to a embedded view using a parameter with strictly property bindings, or with a Tag binding. Tag bindings allow you to store values in a database in the event you want to collect history but will force all sessions to see the same value.

Use a Property Binding

In this example, we'll use a Tank view containing the Tank, LED Display, and Slider that shows passing the 'value' properties from the Tank and the LED Display to the 'value' property of the Slider. Now we will set the Slider to pass its value to a parameter on the embedded view. To demonstrate this, you can use the same Tank view from the Property to Property Binding section above, or you can create another view using the same components as in the example above, and assign the view a new name.

  1. Using your original view from above, select the view in the Project Browser. 
  2. Create a view parameter under Params called 'sliderValue' and make it bidirectional by toggling the Arrow  icon until the arrowhead is at both ends. 




  3. In the Project Browser, create a new view (i.e., Tank3Page) that will contain the embedded view. 
  4. Drag a Embedded View from the Component Palette to the Designer workspace.
    1. With the Embedded View selected, set the 'path' property to your original view (i.e., Tank3) from the dropdown list.
    2. In the Property Editor, create a parameter called 'sliderValue'.  (Hover under the params property and you'll see a plus + icon to add a new param).



  5. Save your project. 
  6. From this new view, put the Designer in Preview Mode . Drag the slider to a value to change the value on the Tank and LED Display. 
  7. You can see from the Embedded View (i.e., Tank3Page), that your sliderValue reflects the same values as your slider. 

Using a Tag Binding

Now, let's pass a property using a Tag binding. Using a Tag binding will allow you to maintain the value of the Slider when you relaunch a client session and store values in a database in the event you want to collect history. Let's continue with the example above.

  1. In the Tag Browser, create a Memory Tag with a data type of Integer, and assign a name (i.e.,Test Tank Tag).



  2. Select the Embedded View. Click on the Binding  icon next to the 'sliderValue' and bind it to the memory Tag (i.e., Test Tank Tag).



  3. This opens the Edit Binding window. Configure the following settings:
    1. Select the Tag binding type.
    2. Under Configure Tag Binding, click the Tag   icon to open the Property popup box. Expand the folders and select the 'Test Tank Tag'. Click OK.
    3. Click the Bidirectional checkbox. allowing the Tag to be updated by the embedded view.
    4. Click OK to save the binding settings.



  4. Now that all your bindings and Tag are configured, let's test out passing a parameter using a Tag. From the original view (Tanks), put the Designer in Preview Mode  and move the Slider to different values. Then, go to the embedded view and see if the value was passed. Your embedded view should reflect the same values as in your original view. 


Tag dropConfig

In the previous example, we set up a Tag binding to pass a property into an embedded view. Now let's use a Tag to create an embedded view with all the property bindings configured by simply dropping the Tag in a view. Ignition will prompt you for the type of component or view you want to create. 

  1. In the Project Browser, select your original view that contains the Tank, LED Display, Slider, and Labels (i.e., Tanks3). 
  2. In the Property Editor, expand the dropConfig property, and then expand the dataTypes property. Configure the following properties:
    1. Select the data type - Int4
    2. Set the param - sliderValue
    3. Identify the action - bind




  3. Let's create a couple of Tags so we can use the 'dropConfig' feature to create multiple embedded views. Copy the Tag you created in the last example (i.e., Test Tank Tag) to make two more Tags, and change their values. 



  4. Create a new large view so we have plenty of room to drop multiple of these tank views on the screen. 
  5. Drag and drop each of your three Tags into your new large view. You will be prompted for what type of component or view you want to create. Choose your original view (i.e., Plant C / Tank3).  



  6. Once you've dragged all three of your Tags into the large view, change the Tag values, it should look something like the following:



  7. If you check the individual tank views, you will see a binding on the 'sliderValue' param. If you open the binding, you will see that each embedded view is pointing to one of the Tags. 


IULocgo


Tag Drop




  • No labels