Data Binding, or Property Binding in Qt terminology, is a programming paradigm that allows binding of data sources to their respective consumers. That means that if a value depends on another, it will automatically be updated whenever the input value changes.
Basic Data Binding in KDBindings¶
The basis for Data Binding in KDBindings is formed by Properties.
They can be combined using arithmetic operators or just plain functions, to create new properties that are bound to the input properties. This means the result of the calculation will be updated automatically every time the input of the calculation changes.
To create a binding, use the free makeBoundProperty function in the KDBindings namespace.
1 2 3 4 5 6 7 8 9 10 11
Pretty much all arithmetic operators are supported, as well as combinations of Properties with constant values.
Declaring functions for use in data binding¶
KDBindings also allows you to declare arbitrary functions as usable in the context of data binding.
node_functions.h file for documentation on the associated macros.
This is already done for some of the
std arithmetic functions, like abs and floor.
You can use the KDBINDINGS_DECLARE_STD_FUNCTION macro to declare more of these when necessary.
1 2 3 4 5 6 7
Binding arbitrary functions¶
makeBoundProperty also accepts functions as binding, so arbitrary code can be executed to produce the new property value.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
No more broken bindings¶
A common mistake in data binding is accidentally breaking a binding by assigning a value to it.
With KDBindings this is no longer possible. Assigning a value to a property that is the result of a data binding will result in an error!
1 2 3 4 5 6 7 8 9
To intentionally remove a binding from a property, use its
Reassigning a Binding¶
Even though KDBindings prevents you from accidentally overriding a binding with a concrete value, assigning a new binding to a Property with an existing binding is possible.
For this, use the makeBinding function instead of makeBoundProperty to create the binding.
It is also possible to use makeBoundProperty, which will move-assign a new Property into the existing one, therefore completely replacing the existing Property with a new one. This means that all signals of the old property will be disconnected (see signals & slots) and any existing data bindings that depended on the property will be removed, which might not be what you want!
Rule of thumb: If you want to create a new property, use makeBoundProperty, if you want to add a new binding to an existing Property, use makeBinding.
1 2 3 4 5 6 7 8 9 10 11 12
KDBindings optionally offers data bindings with controlled, deferred evaluation.
This feature is enabled by passing a KDBindings::BindingEvaluator to makeBoundProperty.
The binding will then only be evaluated when
evaluateAll() is called on the evaluator instance.
Deferred evaluation is useful to avoid unnecessary reevaluation of a binding, as well as controlling the frequency of binding evaluation. Especially in UI applications, only updating the displayed values once per second can help in making them readable, compared to a bunch of values updating at 60Hz.
See the 06-lazy-property-bindings example for more details on how to use deferred evaluation.
Classes involved in data binding are KDBindings::Property, KDBindings::Binding, and KDBindings::BindingEvaluator.
See KDBindings::makeBoundProperty for the different ways to create a binding.
We also recommend you take a look at our examples.