|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
javax.swing.event
类 EventListenerList
java.lang.Object javax.swing.event.EventListenerList
- 所有已实现的接口:
- Serializable
-
public class EventListenerList
- extends Object
- implements Serializable
保存 EventListener 列表的类。单个实例可用来保存使用列表的实例的所有侦听器(所有类型)。该类的责任是使用 EventListenerList 提供类型安全的 API(最好遵守 JavaBeans 规范)和方法,这些方法将事件通知方法指派给列表上适当的 Event Listener。 此类的主要优点是,在没有侦听器的情况下,它相对廉价一些,它在单个地方为事件侦听器提供序列化,同时还提供某种程度的 MT 安全(在正确使用时)。 用例:假定正在定义发送 FooEvent 的类,并希望允许该类的用户注册 FooListener 并在发生 FooEvent 时接收通知。则应该将以下代码添加到类定义中:
EventListenerList listenerList = new EventListenerList(); FooEvent fooEvent = null; public void addFooListener(FooListener l) { listenerList.add(FooListener.class, l); } public void removeFooListener(FooListener l) { listenerList.remove(FooListener.class, l); } // Notify all listeners that have registered interest for // notification on this event type. The event instance // is lazily created using the parameters passed into // the fire method. protected void fireFooXXX() { // Guaranteed to return a non-null array Object[] listeners = listenerList.getListenerList(); // Process the listeners last to first, notifying // those that are interested in this event for (int i = listeners.length-2; i>=0; i-=2) { if (listeners[i]==FooListener.class) { // Lazily create the event: if (fooEvent == null) fooEvent = new FooEvent(this); ((FooListener)listeners[i+1]).fooXXX(fooEvent); } } }应该将 foo 更改为适当的名称,并将 fireFooXxx 也更改为适当的方法名称。FooListener 接口中的每个通知方法都应该有一个 fire 方法。
警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
字段摘要 | |
---|---|
protected Object[] |
listenerList |
构造方法摘要 | |
---|---|
EventListenerList() |
方法摘要 | ||
---|---|---|
|
add(Class<T> t, T l) 将侦听器作为指定类型的侦听器进行添加。 |
|
int |
getListenerCount() 返回此侦听器列表中侦听器的总数。 |
|
int |
getListenerCount(Class<?> t) 返回此侦听器列表中所提供类型的侦听器的总数。 |
|
Object[] |
getListenerList() 将事件侦听器列表以 ListenerType 侦听器对数组的形式传回。 |
|
|
getListeners(Class<T> t) 返回给定类型的所有侦听器组成的数组。 |
|
|
remove(Class<T> t, T l) 将侦听器作为指定类型的侦听器进行移除。 |
|
String |
toString() 返回此 EventListenerList 的字符串表示形式。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
listenerList
protected transient Object[] listenerList
构造方法详细信息 |
---|
EventListenerList
public EventListenerList()
方法详细信息 |
---|
getListenerList
public Object[] getListenerList()
- 将事件侦听器列表以 ListenerType 侦听器对数组的形式传回。注意,出于性能方面的原因,此实现传回实际数据结构,侦听器数据就内部存储在该结构中!此方法可保证传回的是一个非 null 数组,因此不需要在 fire 方法中进行 null 检验。如果当前没有侦听器,则应返回零长度的 Object 数组。 警告!!!绝对“不”能对包含在此数组中的数据进行修改,如果必须进行这类操作,则应在返回数组的副本而非数组本身上进行操作。
-
-
getListeners
public <T extends EventListener> T[] getListeners(Class<T> t)
- 返回给定类型的所有侦听器组成的数组。
-
-
- 返回:
- 指定类型的所有侦听器。
- 抛出:
-
ClassCastException
- 如果所提供的类不能分配给 EventListener - 从以下版本开始:
- 1.3
getListenerCount
public int getListenerCount()
- 返回此侦听器列表中侦听器的总数。
-
-
getListenerCount
public int getListenerCount(Class<?> t)
- 返回此侦听器列表中所提供类型的侦听器的总数。
-
-
add
public <T extends EventListener> void add(Class<T> t, T l)
- 将侦听器作为指定类型的侦听器进行添加。
-
-
- 参数:
-
t
- 要添加的侦听器的类型 -
l
- 要添加的侦听器
remove
public <T extends EventListener> void remove(Class<T> t, T l)
- 将侦听器作为指定类型的侦听器进行移除。
-
-
- 参数:
-
t
- 要移除的侦听器的类型 -
l
- 要移除的侦听器
toString
public String toString()