org.zkoss.zk.ui.event
Class Event

java.lang.Object
  org.zkoss.zk.ui.event.Event

Direct Known Subclasses:

BindingSaveEvent, BookmarkEvent, CheckEvent, ClientInfoEvent, ColSizeEvent, CreateEvent, ForwardEvent, FulfillEvent, InputEvent, KeyEvent, MaximizeEvent, MinimizeEvent, MouseEvent, MoveEvent, OpenEvent, PageSizeEvent, PagingEvent, PortalMoveEvent, ScrollEvent, SelectEvent, SelectionEvent, SizeEvent, UploadEvent, URIEvent, ZIndexEvent

public class Event
extends java.lang.Object

An event sent to the event handler of a component.

Author:

tomyeh

See Also:

Component

Constructor Summary

Event(java.lang.String name, Component target)
Constructs a simple event.

Event(java.lang.String name, Component target, java.lang.Object data)
Constructs a simple event.

Method Summary

java.lang.Object	getData() Returns the data accompanies with this event, or null if not available.
java.lang.String	getName() Returns the event name.
Page	getPage() Returns the page owning this event, or null if broadcast.
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.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Event

public Event(java.lang.String name,
             Component target)

Constructs a simple event.

Parameters:

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

Event

public Event(java.lang.String name,
             Component target,
             java.lang.Object data)

Constructs a simple event.

Parameters:

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

data - an arbitary data

Method Detail

getName

public final java.lang.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 java.lang.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(java.lang.String, org.zkoss.zk.ui.event.EventListener) and Page.addEventListener(java.lang.String, org.zkoss.zk.ui.event.EventListener).

stopPropagation

public void stopPropagation()

Stops the propagation for this event.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object