Module javafx.base

Class StringProperty

    • Constructor Detail

      • StringProperty

        public StringProperty​()
    • Method Detail

      • bindBidirectional

        public void bindBidirectional​(Property<String> other)
        Create a bidirectional binding between this Property and another one. Bidirectional bindings exists independently of unidirectional bindings. So it is possible to add unidirectional binding to a property with bidirectional binding and vice-versa. However, this practice is discouraged.

        It is possible to have multiple bidirectional bindings of one Property.

        JavaFX bidirectional binding implementation use weak listeners. This means bidirectional binding does not prevent properties from being garbage collected.

        Specified by:
        bindBidirectional in interface Property<String>
        Parameters:
        other - the other Property
      • bindBidirectional

        public void bindBidirectional​(Property<?> other,
                                      Format format)
        Create a bidirectional binding between this StringProperty and another arbitrary property. Relies on an implementation of Format for conversion.
        Parameters:
        other - the other Property
        format - the Format used to convert between this StringProperty and the other Property
        Throws:
        NullPointerException - if other or format is null
        IllegalArgumentException - if other is this
        Since:
        JavaFX 2.1
      • bindBidirectional

        public <T> void bindBidirectional​(Property<T> other,
                                          StringConverter<T> converter)
        Create a bidirectional binding between this StringProperty and another arbitrary property. Relies on an implementation of StringConverter for conversion.
        Type Parameters:
        T - the type of the wrapped Object
        Parameters:
        other - the other Property
        converter - the StringConverter used to convert between this StringProperty and the other Property
        Throws:
        NullPointerException - if other or converter is null
        IllegalArgumentException - if other is this
        Since:
        JavaFX 2.1
      • unbindBidirectional

        public void unbindBidirectional​(Property<String> other)
        Remove a bidirectional binding between this Property and another one. If no bidirectional binding between the properties exists, calling this method has no effect. It is possible to unbind by a call on the second property. This code will work:
             property1.bindBirectional(property2);
             property2.unbindBidirectional(property1);
         
        Specified by:
        unbindBidirectional in interface Property<String>
        Parameters:
        other - the other Property
      • unbindBidirectional

        public void unbindBidirectional​(Object other)
        Remove a bidirectional binding between this Property and another one. If no bidirectional binding between the properties exists, calling this method has no effect.
        Parameters:
        other - the other Property
        Throws:
        NullPointerException - if other is null
        IllegalArgumentException - if other is this
        Since:
        JavaFX 2.1
      • toString

        public String toString​()
        Returns a string representation of this StringProperty object.
        Overrides:
        toString in class ReadOnlyStringProperty
        Returns:
        a string representation of this StringProperty object.