Package org.zkoss.zk.ui.event

Class Event

java.lang.Object

org.zkoss.zk.ui.event.Event

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AfterSizeEvent, BookmarkEvent, CheckEvent, ClientInfoEvent, CreateEvent, DOMExceptionEvent, ForwardEvent, FulfillEvent, HistoryPopStateEvent, InputEvent, KeyEvent, MaximizeEvent, MinimizeEvent, MouseEvent, MoveEvent, OpenEvent, ProxyEvent, ScriptErrorEvent, ScrollEvent, SelectEvent, SelectionEvent, SizeEvent, SlideEvent, SortEvent, StateChangeEvent, StubEvent, SwipeEvent, UploadEvent, URIEvent, VisibilityChangeEvent, ZIndexEvent

public class Event
extends Object
implements Serializable

An event sent to the event handler of a component.

Author:

tomyeh

See Also:

• Component
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
Event(String name)	Constructs a simple event without target.
Event(String name, Component target)	Constructs a simple event.
Event(String name, Component target, Object data)	Constructs a simple event.

Method Summary

Modifier and Type	Method	Description
Object	getData()	Returns the data accompanies with this event, or null if not available.
static Event	getEvent(AuRequest request)	Creates an instance of Event based on the specified request.
final String	getName()	Returns the event name.
final Page	getPage()	Returns the page owning this event, or null if broadcast.
final Component	getTarget()	Returns the target component that receives this event, or null if broadcast.
boolean	isPropagatable()	Returns whether this event is propagatable.
void	stopPropagation()	Stops the propagation for this event.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

Event

public Event(String name)

Constructs a simple event without target.

Parameters:

name - the name of the event

Since:

5.0.0

Event

public Event(String name,
 Component target)

Constructs a simple event.

Parameters:

name - the name of the event

target - the component to receive this event, or null to indicate broadcasting the event to all root components.

Event

public Event(String name,
 Component target,
 Object data)

Constructs a simple event.

Parameters:

name - the name of the event

target - the component to receive this event, or null to indicate broadcasting the event to all root components.

data - an arbitrary data

Method Details

getEvent

public static Event getEvent(AuRequest request)

Creates an instance of Event based on the specified request.

getName

public final String getName()

Returns the event name.

getTarget

public final Component getTarget()

Returns the target component that receives this event, or null if broadcast.

getPage

public final Page getPage()

Returns the page owning this event, or null if broadcast.

getData

public Object getData()

Returns the data accompanies with this event, or null if not available.

isPropagatable

public boolean isPropagatable()

Returns whether this event is propagatable.

Default: true.

It becomes false if stopPropagation() is called. If true, the event will be sent to the following event listener (EventListener) being registered by Component.addEventListener(int, java.lang.String, org.zkoss.zk.ui.event.EventListener<? extends org.zkoss.zk.ui.event.Event>) and Page.addEventListener(java.lang.String, org.zkoss.zk.ui.event.EventListener<? extends org.zkoss.zk.ui.event.Event>).

stopPropagation

public void stopPropagation()

Stops the propagation for this event.

toString

public String toString()

Overrides:

toString in class Object