Module javafx.base

软件包 javafx.beans.property

Class MapPropertyBase<K,V>

java.lang.Object

javafx.beans.binding.MapExpression<K,V>

javafx.beans.property.ReadOnlyMapProperty<K,V>

javafx.beans.property.MapProperty<K,V>

javafx.beans.property.MapPropertyBase<K,V>

参数类型

K - K的关键元素的 Map

V - V的值元素的 Map

All Implemented Interfaces:

Map<K,V> ， Observable ， Property<K> ， ReadOnlyProperty<K> ， ObservableMapValue<K,V> ， ObservableObjectValue<K> ， ObservableValue<K> ， WritableMapValue<K,V> ， WritableObjectValue<K> ， WritableValue<K> ， ObservableMap<K,V>

已知直接子类：

SimpleMapProperty

public abstract class MapPropertyBase<K,V>
extends MapProperty<K,V>

MapPropertyBase类是包装ObservableMap的属性的基类。 它提供除了ReadOnlyProperty.getBean()和ReadOnlyProperty.getName()方法之外的属性所需的所有功能，这些方法必须通过扩展类来实现。

从以下版本开始：

JavaFX 2.1

另请参见：

ObservableMap ， MapProperty

Property Summary

Properties

Type	Property	描述
ReadOnlyBooleanProperty	empty	一个布尔属性是 true ，如果地图是空的。
ReadOnlyIntegerProperty	size	表示地图大小的整数属性。

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

构造方法摘要

构造方法

Constructor	描述
MapPropertyBase()	构造器 MapPropertyBase
MapPropertyBase(ObservableMap<K,V> initialValue)	MapPropertyBase的构造 MapPropertyBase 。

方法摘要

Modifier and Type	方法	描述
void	addListener(InvalidationListener listener)	添加一个InvalidationListener ，当Observable无效时，它将被通知。
void	addListener(ChangeListener<? super ObservableMap<K,V>> listener)	添加一个ChangeListener ，当ObservableValue的值发生变化时，它将被通知。
void	addListener(MapChangeListener<? super K,? super V> listener)	添加一个监听器到这个可观察的地图。
void	bind(ObservableValue<? extends ObservableMap<K,V>> newObservable)	为此创建一个单向绑定 Property 。
ReadOnlyBooleanProperty	emptyProperty()	一个布尔属性是 true ，如果地图是空的。
protected void	fireValueChangedEvent()	发送通知到所有连接InvalidationListeners ， ChangeListeners ，并MapChangeListener 。
protected void	fireValueChangedEvent(MapChangeListener.Change<? extends K,? extends V> change)	发送通知到所有连接InvalidationListeners ， ChangeListeners ，并MapChangeListener 。
ObservableMap<K,V>	get()	获取包装的值。
protected void	invalidated()	可以覆盖方法 invalidated()以接收无效通知。
boolean	isBound()	可以用来检查，如果一个 Property是绑定的。
void	removeListener(InvalidationListener listener)	从监听器列表中删除给定的监听器，当 Observable的值变为无效时通知 Observable 。
void	removeListener(ChangeListener<? super ObservableMap<K,V>> listener)	从监听器列表中删除给定的监听器，当 ObservableValue的值发生变化时通知该 ObservableValue 。
void	removeListener(MapChangeListener<? super K,? super V> listener)	试图从这个可观察的地图中删除一个听众。
void	set(ObservableMap<K,V> newValue)	设置包装的值。
ReadOnlyIntegerProperty	sizeProperty()	表示地图大小的整数属性。
String	toString()	返回此 MapPropertyBase对象的字符串表示形式。
void	unbind()	删除这个 Property的单向绑定。

Methods inherited from interface java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entry, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, of, of, of, of, of, of, of, of, of, of, of, ofEntries, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Methods inherited from class javafx.beans.binding.MapExpression

asString, clear, containsKey, containsValue, entrySet, get, getSize, getValue, isEmpty, isEqualTo, isNotEqualTo, isNotNull, isNull, keySet, mapExpression, put, putAll, remove, size, valueAt, valueAt, values

Methods inherited from class javafx.beans.property.MapProperty

bindBidirectional, setValue, unbindBidirectional

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javafx.beans.value.ObservableValue

getValue

Methods inherited from class javafx.beans.property.ReadOnlyMapProperty

bindContent, bindContentBidirectional, equals, hashCode, unbindContent, unbindContentBidirectional

Methods inherited from interface javafx.beans.property.ReadOnlyProperty

getBean, getName

Methods inherited from interface javafx.beans.value.WritableValue

getValue

Property Detail

size

public ReadOnlyIntegerProperty sizeProperty

Specified by:

sizeProperty在 MapExpression<K,V>

另请参见：

MapExpression.getSize()

empty

public ReadOnlyBooleanProperty emptyProperty

Specified by:

emptyProperty MapExpression<K,V>

另请参见：

MapExpression.isEmpty()

构造方法详细信息

MapPropertyBase

public MapPropertyBase()

构造函数 MapPropertyBase

MapPropertyBase

public MapPropertyBase(ObservableMap<K,V> initialValue)

MapPropertyBase的构造 MapPropertyBase 。

参数

initialValue - 包装值的初始值

方法详细信息

sizeProperty

public ReadOnlyIntegerProperty sizeProperty()

描述从类复制： MapExpression

表示地图大小的整数属性。

Specified by:

sizeProperty在 MapExpression<K,V>

另请参见：

MapExpression.getSize()

emptyProperty

public ReadOnlyBooleanProperty emptyProperty()

描述从类复制： MapExpression

一个布尔属性是 true ，如果地图是空的。

Specified by:

emptyProperty在 MapExpression<K,V>

另请参见：

MapExpression.isEmpty()

addListener

public void addListener(InvalidationListener listener)

说明从接口Observable复制

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

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

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

参数

listener - listener注册

另请参见：

Observable.removeListener(InvalidationListener)

removeListener

public void removeListener(InvalidationListener listener)

描述从接口Observable复制

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

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

参数

listener - 要删除的侦听器

另请参见：

Observable.addListener(InvalidationListener)

addListener

public void addListener(ChangeListener<? super ObservableMap<K,V>> listener)

描述从接口ObservableValue复制

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

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

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

参数

listener - listener注册

另请参见：

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super ObservableMap<K,V>> listener)

描述从接口ObservableValue复制

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

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

参数

listener - 要删除的侦听器

另请参见：

ObservableValue.addListener(ChangeListener)

addListener

public void addListener(MapChangeListener<? super K,? super V> listener)

描述从接口ObservableMap复制

添加一个监听器到这个可观察的地图。

参数

listener - 用于监听列表的监听器更改

removeListener

public void removeListener(MapChangeListener<? super K,? super V> listener)

描述从接口ObservableMap复制

试图从这个可观察的地图中删除一个听众。 如果听众没有附加到这个地图，没有任何反应。

参数

listener - 要删除的侦听器

fireValueChangedEvent

protected void fireValueChangedEvent()

发送通知到所有连接InvalidationListeners ， ChangeListeners ，并MapChangeListener 。 通过调用set(javafx.collections.ObservableMap)手动或绑定属性的情况下，如果绑定变为无效，则调用此方法。

fireValueChangedEvent

protected void fireValueChangedEvent(MapChangeListener.Change<? extends K,? extends V> change)

发送通知到所有连接InvalidationListeners ， ChangeListeners ，并MapChangeListener 。 当列表的内容更改时调用此方法。

参数

change - 需要传播的更改

invalidated

protected void invalidated()

可以覆盖方法invalidated()以接收无效通知。 这是Objects定义属性的首选选项，因为它需要更少的内存。 默认实现为空。

get

public ObservableMap<K,V> get()

描述从接口WritableObjectValue复制

获取包装的值。 这必须与从WritableValue.getValue()返回的值相同。

此方法仅存在于将WritableObjectValue API与WritableBooleanValue和WritableNumberValue的子类对齐

结果

当前值

set

public void set(ObservableMap<K,V> newValue)

描述从接口WritableObjectValue复制

设置包装的值。 应相当于WritableValue.setValue(java.lang.Object)

参数

newValue - 新的价值

另请参见：

WritableObjectValue.get()

isBound

public boolean isBound()

描述从接口Property复制

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

结果

true如果 Property是绑定的，另外 false

另请参见：

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

bind

public void bind(ObservableValue<? extends ObservableMap<K,V>> newObservable)

说明从界面： Property复制

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

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

参数

newObservable - 可观察这 Property应该绑定。

unbind

public void unbind()

描述从接口Property复制

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

另请参见：

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

toString

public String toString()

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

重写：

toString在 MapProperty<K,V>

结果

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