Module javafx.base

软件包 javafx.beans.property.adapter

Class JavaBeanLongProperty

java.lang.Object

javafx.beans.binding.NumberExpressionBase

javafx.beans.binding.LongExpression

javafx.beans.property.ReadOnlyLongProperty

javafx.beans.property.LongProperty

javafx.beans.property.adapter.JavaBeanLongProperty

All Implemented Interfaces:

NumberExpression ， Observable ， JavaBeanProperty<Number> ， ReadOnlyJavaBeanProperty<Number> ， Property<Number> ， ReadOnlyProperty<Number> ， ObservableLongValue ， ObservableNumberValue ， ObservableValue<Number> ， WritableLongValue ， WritableNumberValue ， WritableValue<Number>

public final class JavaBeanLongProperty
extends LongProperty
implements JavaBeanProperty<Number>

A JavaBeanLongProperty在类型为long或Long的常规Java Bean属性和JavaFX LongProperty之间提供了一个适配器。 它不能直接创建，但必须使用JavaBeanLongPropertyBuilder 。

至少Java Bean类必须为该属性实现一个getter和一个setter。 该类，以及getter和setter方法必须被声明为public。 如果调用此类的实例的getter，则返回Java Bean的属性。 如果调用setter，该值将被传递给Java Bean属性。 如果Java Bean属性是绑定的（即它支持PropertyChangeListeners），那么这个JavaBeanLongProperty将会意识到Java Bean中的更改。 否则可以通过致电fireValueChangedEvent()通知有关更改。 如果Java Bean属性也受到约束（即它支持VetoableChangeListeners）， JavaBeanLongProperty将拒绝更改，如果它绑定到一个ObservableValue<Long> 。

将应用程序部署为模块

如果Java Bean类在一个命名的模块中，那么它必须能反映出javafx.base模块的可访问性。 如果模块opens包含至少包含javafx.base模块，则可以反射访问类。

例如，如果com.foo.MyBeanClass在foo.app模块中，则module-info.java可能如下所示：

  module foo.app { opens com.foo to javafx.base; } 

或者，如果模块exports无条件地包含包装，则可以反射地访问该类 。

从以下版本开始：

JavaFX 2.1

另请参见：

LongProperty ， JavaBeanLongPropertyBuilder

方法摘要

Modifier and Type	方法	描述
void	addListener(InvalidationListener listener)	添加一个InvalidationListener ，当Observable无效时，它将被通知。
void	addListener(ChangeListener<? super Number> listener)	添加一个ChangeListener ，当ObservableValue的值发生变化时，它将被通知。
void	bind(ObservableValue<? extends Number> observable)	为此 Property创建一个单向绑定。
void	dispose()	信号到JavaFX属性，它将不再被使用，任何引用都可以被删除。
void	fireValueChangedEvent()	如果Java Bean属性未绑定（即它不支持PropertyChangeListeners），则可以调用此方法来通知适配器更改Java Bean值。
long	get()	获取包装的值。
Object	getBean()	返回包含此属性的 Object 。
String	getName()	返回此属性的名称。
boolean	isBound()	可以用来检查，如果一个 Property是绑定的。
void	removeListener(InvalidationListener listener)	从监听器列表中删除给定的监听器，当 Observable的值变为无效时通知 Observable 。
void	removeListener(ChangeListener<? super Number> listener)	从监听器列表中删除给定的监听器，当 ObservableValue的值发生变化时通知 ObservableValue 。
void	set(long value)	设置包装的值。
String	toString()	返回此 JavaBeanLongProperty对象的字符串表示形式。
void	unbind()	删除此 Property的单向绑定。

Methods inherited from class javafx.beans.binding.LongExpression

add, add, add, add, divide, divide, divide, divide, doubleValue, floatValue, getValue, intValue, longExpression, longExpression, longValue, multiply, multiply, multiply, multiply, negate, subtract, subtract, subtract, subtract

Methods inherited from class javafx.beans.property.LongProperty

asObject, bindBidirectional, longProperty, setValue, unbindBidirectional

Methods inherited from class javafx.beans.binding.NumberExpressionBase

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javafx.beans.value.ObservableValue

getValue

Methods inherited from interface javafx.beans.property.Property

bindBidirectional, unbindBidirectional

Methods inherited from class javafx.beans.property.ReadOnlyLongProperty

readOnlyLongProperty

Methods inherited from interface javafx.beans.value.WritableValue

getValue, setValue

方法详细信息

get

public long get()

获取包装的值。 与WritableValue.getValue()不同，此方法返回原始long。 需要与WritableValue.getValue()相同。

Specified by:

get在接口 ObservableLongValue

Specified by:

get在接口 WritableLongValue

结果

当前值

异常

UndeclaredThrowableException - 如果调用Java Bean属性的getter抛出一个 IllegalAccessException或一个 InvocationTargetException 。

set

public void set(long value)

设置包装的值。 与WritableLongValue.setValue(java.lang.Number)不同，此方法使用原始长。

Specified by:

set在接口 WritableLongValue

参数

value - 新的价值

异常

UndeclaredThrowableException - 如果调用Java Bean属性的getter抛出一个 IllegalAccessException或一个 InvocationTargetException 。

bind

public void bind(ObservableValue<? extends Number> observable)

为此创建一个单向绑定Property 。

请注意，JavaFX具有通过弱侦听器实现的所有绑定调用。 这意味着bound属性可以被垃圾回收并停止更新。

Specified by:

bind在接口 Property<Number>

参数

observable - 可观察到这个 Property应该绑定。

unbind

public void unbind()

删除此Property的单向绑定。 如果Property未绑定，则调用此方法没有任何作用。

Specified by:

unbind在接口 Property<Number>

另请参见：

Property.bind(javafx.beans.value.ObservableValue)

isBound

public boolean isBound()

可以用来检查，如果一个 Property是绑定的。

Specified by:

isBound在接口 Property<Number>

结果

true如果 Property绑定，否则 false

另请参见：

Property.bind(javafx.beans.value.ObservableValue)

getBean

public Object getBean()

返回包含此属性的Object 。 如果此属性未包含在Object ，则返回null 。

Specified by:

getBean在接口 ReadOnlyProperty<Number>

结果

包含 Object或 null

getName

public String getName()

返回此属性的名称。 如果该属性没有名称，则此方法返回一个空的String 。

Specified by:

getName在接口 ReadOnlyProperty<Number>

结果

的名字或一个空的 String

addListener

public void addListener(ChangeListener<? super Number> listener)

添加一个ChangeListener ，当ObservableValue的值发生变化时，它将被通知。 如果同一个监听器被多次添加，那么它将被多次通知。 也就是说，没有检查确保唯一性。

请注意，相同的实际ChangeListener实例可能会安全注册为不同的ObservableValues 。

ObservableValue存储对侦听器的强烈引用，这将阻止侦听器被垃圾回收，并可能导致内存泄漏。 建议您在使用后通过调用removeListener注销一个监听器，或者使用WeakChangeListener的一个实例来避免这种情况。

Specified by:

addListener在接口 ObservableValue<Number>

参数

listener - listener注册

另请参见：

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super Number> listener)

从监听器列表中删除给定的监听器，当ObservableValue的值发生变化时通知ObservableValue 。

如果给定的侦听器以前没有被注册过（即它从未被添加过），那么这个方法调用是一个无操作的。 如果以前已经添加，那么它将被删除。 如果多次添加，那么只有第一次出现将被删除。

Specified by:

removeListener接口 ObservableValue<Number>

参数

listener - 要删除的侦听器

另请参见：

ObservableValue.addListener(ChangeListener)

addListener

public void addListener(InvalidationListener listener)

添加一个InvalidationListener ，当Observable变得无效时，它将被通知。 如果同一个监听器被多次添加，那么它将被多次通知。 也就是说，没有检查确保唯一性。

请注意，相同的实际InvalidationListener实例可以安全地注册到不同的Observables 。

Observable存储对侦听器的强烈引用，这将阻止侦听器被垃圾回收，并可能导致内存泄漏。 建议您在使用后通过调用removeListener注销一个监听器，或者使用WeakInvalidationListener的一个实例来避免这种情况。

Specified by:

addListener在接口 Observable

参数

listener - listener注册

另请参见：

Observable.removeListener(InvalidationListener)

removeListener

public void removeListener(InvalidationListener listener)

从监听器列表中删除给定的监听器，当Observable的值变为无效时通知Observable 。

如果给定的侦听器以前没有被注册过（即它从未被添加过），那么这个方法调用是一个无操作的。 如果以前已经添加，那么它将被删除。 如果多次添加，那么只有第一次出现将被删除。

Specified by:

removeListener在接口 Observable

参数

listener - 要删除的侦听器

另请参见：

Observable.addListener(InvalidationListener)

fireValueChangedEvent

public void fireValueChangedEvent()

如果Java Bean属性未绑定（即它不支持PropertyChangeListeners），则可以调用此方法来通知适配器更改Java Bean值。

Specified by:

fireValueChangedEvent在接口 ReadOnlyJavaBeanProperty<Number>

dispose

public void dispose()

信号到JavaFX属性，它将不再被使用，任何引用都可以被删除。 此方法的调用通常导致属性停止通过注销其监听器来观察Java Bean属性。

Specified by:

dispose在接口 ReadOnlyJavaBeanProperty<Number>

toString

public String toString()

返回此 JavaBeanLongProperty对象的字符串表示形式。

重写：

toString在 LongProperty

结果

这个 JavaBeanLongProperty对象的字符串表示形式。