|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface EventListener<T extends Event>
An event listener that will be notified when an event occurs, if it is
registered to Component.addEventListener(int, java.lang.String, org.zkoss.zk.ui.event.EventListener extends org.zkoss.zk.ui.event.Event>)
.
If an event listener also implements Deferrable
and Deferrable.isDeferrable()
returns true, the event
for the listener will NOT be sent to the server immediately (when it
is fired at the client). It is called the deferrable event listener.
It helps to improve the performance since the deferred events will
be 'packed' together and sent to the server at once. It is usually used
for event listeners that maintains the application states, rather
than generating visual responses.
By default (i.e., if Deferrable
is not implemented), the event
listener is not deferrable. It is also called the ASAP event listener.
By default, The event listener is invoked after the event handlers registered
in a ZUML page (i.e., the onXXX attribute).
If you prefer a listener to invoke earlier than the ZUML's event handlers,
you could register it with a priority equaling or higher than 1000
(with Component.addEventListener(int, String, EventListener)
).
Deferrable
,
SerializableEventListener
Method Summary | |
---|---|
void |
onEvent(T event)
Notifies this listener that an event occurs. |
Method Detail |
---|
void onEvent(T event) throws java.lang.Exception
Component.addEventListener(int, java.lang.String, org.zkoss.zk.ui.event.EventListener extends org.zkoss.zk.ui.event.Event>)
or
Page.addEventListener(java.lang.String, org.zkoss.zk.ui.event.EventListener extends org.zkoss.zk.ui.event.Event>)
.
If you want to forward the event to other component,
use Events.sendEvent(org.zkoss.zk.ui.Component, org.zkoss.zk.ui.event.Event)
.
java.lang.Exception
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |