Generates a bidirectional binding (or "bind with inverse") between a
String
-javafx.beans.property.Property
and another Property
using the specified Format
for conversion.
A bidirectional binding is a binding that works in both directions. If
two properties a
and b
are linked with a bidirectional
binding and the value of a
changes, b
is set to the same
value automatically. And vice versa, if b
changes, a
is
set to the same value.
A bidirectional binding can be removed with
unbindBidirectional(Object, Object)
.
Note: this implementation of a bidirectional binding behaves differently from all other bindings here in two important aspects. A property that is linked to another property with a bidirectional binding can still be set (usually bindings would throw an exception). Secondly bidirectional bindings are calculated eagerly, i.e. a bound property is updated immediately.
stringProperty
| the String Property | |
otherProperty
| the other (non- String ) Property | |
format
| the Format used to convert between the properties |
NullPointerException
| if one of the properties or the format is null | |
IllegalArgumentException
| if both properties are equal |
Diagram: Bindings