public final class JavaBeanLongProperty extends LongProperty implements JavaBeanProperty<Number>
JavaBeanLongProperty
provides an adapter between a regular
Java Bean property of type long
or Long
and a JavaFX
LongProperty
. It cannot be created directly, but a
JavaBeanLongPropertyBuilder
has to be used.
As a minimum, the Java Bean must implement a getter and a setter for the
property. If the getter of an instance of this class is called, the property of
the Java Bean is returned. If the setter is called, the value will be passed
to the Java Bean property. If the Java Bean property is bound (i.e. it supports
PropertyChangeListeners), this JavaBeanLongProperty
will be
aware of changes in the Java Bean. Otherwise it can be notified about
changes by calling fireValueChangedEvent()
. If the Java Bean property
is also constrained (i.e. it supports VetoableChangeListeners), this
JavaBeanLongProperty
will reject changes, if it is bound to an
ObservableValue<Long>
.
LongProperty
,
JavaBeanLongPropertyBuilder
Modifier and Type | Method and Description |
---|---|
void |
addListener(ChangeListener<? super Number> listener)
Adds a
ChangeListener which will be notified whenever the value
of the ObservableValue changes. |
void |
addListener(InvalidationListener listener)
Adds an
InvalidationListener which will be notified whenever the
Observable becomes invalid. |
void |
bind(ObservableValue<? extends Number> observable)
Create a unidirection binding for this
Property . |
void |
dispose()
Signals to the JavaFX property that it will not be used anymore and any
references can be removed.
|
void |
fireValueChangedEvent()
This method can be called to notify the adapter of a change of the Java
Bean value, if the Java Bean property is not bound (i.e.
|
long |
get()
Get the wrapped value.
|
Object |
getBean()
Returns the
Object that contains this property. |
String |
getName()
Returns the name of this property.
|
boolean |
isBound()
Can be used to check, if a
Property is bound. |
void |
removeListener(ChangeListener<? super Number> listener)
Removes the given listener from the list of listeners, that are notified
whenever the value of the
ObservableValue changes. |
void |
removeListener(InvalidationListener listener)
Removes the given listener from the list of listeners, that are notified
whenever the value of the
Observable becomes invalid. |
void |
set(long value)
Set the wrapped value.
|
String |
toString()
Returns a string representation of this
JavaBeanLongProperty object. |
void |
unbind()
Remove the unidirectional binding for this
Property . |
asObject, bindBidirectional, longProperty, setValue, unbindBidirectional
readOnlyLongProperty
add, add, add, add, divide, divide, divide, divide, doubleValue, floatValue, getValue, intValue, longExpression, longExpression, longValue, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract
add, asString, asString, asString, divide, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, greaterThanOrEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, isNotEqualTo, lessThan, lessThan, lessThan, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, lessThanOrEqualTo, multiply, numberExpression, subtract
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
bindBidirectional, unbindBidirectional
getValue
getValue, setValue
public long get()
WritableValue.getValue()
,
this method returns primitive long.
Needs to be identical to WritableValue.getValue()
.get
in interface ObservableLongValue
get
in interface WritableLongValue
UndeclaredThrowableException
- if calling the getter of the Java Bean
property throws an IllegalAccessException
or an
InvocationTargetException
.public void set(long value)
WritableLongValue.setValue(java.lang.Number)
,
this method uses primitive long.set
in interface WritableLongValue
value
- The new valueUndeclaredThrowableException
- if calling the getter of the Java Bean
property throws an IllegalAccessException
or an
InvocationTargetException
.public void bind(ObservableValue<? extends Number> observable)
Property
.
Note that JavaFX has all the bind calls implemented through weak listeners. This means the bound property can be garbage collected and stopped from being updated.
public void unbind()
Property
.
If the Property
is not bound, calling this method has no effect.unbind
in interface Property<Number>
Property.bind(javafx.beans.value.ObservableValue)
public boolean isBound()
Property
is bound.isBound
in interface Property<Number>
true
if the Property
is bound, false
otherwiseProperty.bind(javafx.beans.value.ObservableValue)
public Object getBean()
Object
that contains this property. If this property
is not contained in an Object
, null
is returned.getBean
in interface ReadOnlyProperty<Number>
Object
or null
public String getName()
String
.getName
in interface ReadOnlyProperty<Number>
String
public void addListener(ChangeListener<? super Number> listener)
ChangeListener
which will be notified whenever the value
of the ObservableValue
changes. If the same listener is added
more than once, then it will be notified more than once. That is, no
check is made to ensure uniqueness.
Note that the same actual ChangeListener
instance may be safely
registered for different ObservableValues
.
The ObservableValue
stores a strong reference to the listener
which will prevent the listener from being garbage collected and may
result in a memory leak. It is recommended to either unregister a
listener by calling removeListener
after use or to use an instance of
WeakChangeListener
avoid this situation.
addListener
in interface ObservableValue<Number>
listener
- The listener to registerObservableValue.removeListener(ChangeListener)
public void removeListener(ChangeListener<? super Number> listener)
ObservableValue
changes.
If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed.
removeListener
in interface ObservableValue<Number>
listener
- The listener to removeObservableValue.addListener(ChangeListener)
public void addListener(InvalidationListener listener)
InvalidationListener
which will be notified whenever the
Observable
becomes invalid. If the same
listener is added more than once, then it will be notified more than
once. That is, no check is made to ensure uniqueness.
Note that the same actual InvalidationListener
instance may be
safely registered for different Observables
.
The Observable
stores a strong reference to the listener
which will prevent the listener from being garbage collected and may
result in a memory leak. It is recommended to either unregister a
listener by calling removeListener
after use or to use an instance of
WeakInvalidationListener
avoid this situation.
addListener
in interface Observable
listener
- The listener to registerObservable.removeListener(InvalidationListener)
public void removeListener(InvalidationListener listener)
Observable
becomes invalid.
If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed.
removeListener
in interface Observable
listener
- The listener to removeObservable.addListener(InvalidationListener)
public void fireValueChangedEvent()
fireValueChangedEvent
in interface ReadOnlyJavaBeanProperty<Number>
public void dispose()
dispose
in interface ReadOnlyJavaBeanProperty<Number>
public String toString()
JavaBeanLongProperty
object.toString
in class LongProperty
JavaBeanLongProperty
object.Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 2008, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.