org.zkoss.zul
Class Chart

java.lang.Object
  org.zkoss.zk.ui.AbstractComponent
      org.zkoss.zk.ui.HtmlBasedComponent
          org.zkoss.zul.impl.XulElement
              org.zkoss.zul.Image
                  org.zkoss.zul.Imagemap
                      org.zkoss.zul.Chart

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, HtmlBasedComponent, Component, Scope, ComponentCtrl, Chart, Image, Imagemap, XulElement

public class Chart
extends Imagemap
implements Chart

The generic chart component. Developers set proper chart type, data model, and the threeD (3D) attribute to draw proper chart. The model and type must match to each other; or the result is unpredictable. The 3D chart is not supported on all chart type.

type	model	3D
area	CategoryModel or XYModel	No
bar	CategoryModel	Yes
bubble	XYZModel	No
candlestick	HiLoModel	No
gantt	GanttModel	No
highlow	HiLoModel	No
histogram	XYModel	No
line	CategoryModel or XYModel	Yes
pie	PieModel	Yes
polar	XYModel	No
ring	PieModel	No
scatter	XYModel	No
stacked_bar	CategoryModel	Yes
stacked_area	CategoryModel or XYModel	No
step	XYModel	No
step_area	XYModel	No
time_series	XYModel	No
wafermap	WaferMapModel	No
waterfall	CategoryModel	No
wind	XYZModel	No

Author:

henrichen

See Also:

ChartEngine, ChartModel, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.zkoss.zul.Image

Image.ExtraCtrl

Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent

AbstractComponent.Children

Field Summary

static java.lang.String	AREA
static java.lang.String	BAR
static java.lang.String	BUBBLE
static java.lang.String	CANDLESTICK
static java.lang.String	DAY
static java.lang.String	GANTT
static java.lang.String	HIGHLOW
static java.lang.String	HISTOGRAM
static java.lang.String	HOUR
static java.lang.String	LINE
static java.lang.String	MILLISECOND
static java.lang.String	MINUTE
static java.lang.String	MONTH
static java.lang.String	PIE
static java.lang.String	POLAR
static java.lang.String	QUARTER
static java.lang.String	RING
static java.lang.String	SCATTER
static java.lang.String	SECOND
static java.lang.String	STACKED_AREA
static java.lang.String	STACKED_BAR
static java.lang.String	STEP
static java.lang.String	STEP_AREA
static java.lang.String	TIME_SERIES
static java.lang.String	WAFERMAP
static java.lang.String	WATERFALL
static java.lang.String	WEEK
static java.lang.String	WIND
static java.lang.String	YEAR

Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent

_zclass, RS_NO_DISPLAY, RS_NO_HEIGHT, RS_NO_WIDTH

Fields inherited from class org.zkoss.zk.ui.AbstractComponent

_visible

Fields inherited from interface org.zkoss.zk.ui.Component

APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE

Constructor Summary

Chart()

Method Summary

boolean	addEventListener(java.lang.String evtnm, EventListener listener) Adds an event listener to specified event for this component.
java.lang.Object	clone() Clones the component.
ChartAreaListener	getAreaListener() Returns the renderer to render each area, or null if the default renderer is used.
int	getBgAlpha() Get the background alpha (transparency, 0 ~ 255, opacue).
java.lang.String	getBgColor() Get the background color of the chart (in string as #RRGGBB).
int[]	getBgRGB() Get the background color in int array (0: red, 1: green, 2:blue).
java.lang.String	getDateFormat() Returns the date format used by date related Chart.
ChartEngine	getEngine() Returns the implemetation chart engine.
int	getFgAlpha() Get the foreground alpha (transparency, 0 ~ 255, opacue).
int	getIntHeight() Get the chart int width in pixel; to be used by the derived subclass.
int	getIntWidth() Get the chart int width in pixel; to be used by the derived subclass.
ChartModel	getModel() Returns the chart model associated with this chart, or null if this chart is not associated with any chart data model.
java.lang.String	getOrient() Get the chart orientation (vertical or horizontal)
int	getPaneAlpha() Get the pane alpha (transparency, 0 ~ 255, opacue).
java.lang.String	getPaneColor() Get the pane color of the chart (in string as #RRGGBB).
int[]	getPaneRGB() Get the pane color in int array (0: red, 1: green, 2:blue).
java.lang.String	getPeriod() Returns the period used in Time Series Chart.
java.util.TimeZone	getTimeZone() Returns the time zone that this Time Series Chart belongs to, or null if the default time zone is used.
java.lang.String	getTitle() Get the chart's title.
java.lang.String	getType() Get the chart's type.
java.lang.String	getXAxis() Get the label in xAxis.
java.lang.String	getYAxis() Get the label in yAxis.
boolean	isShowLegend() Check whether show the legend of the chart.
boolean	isShowTooltiptext() Check whether show the tooltiptext.
boolean	isThreeD() Whether a 3d chart.
protected ChartEngine	newChartEngine() Instantiates the default chart engine.
void	setAreaListener(ChartAreaListener listener) Sets the renderer which is used to render each area.
void	setAreaListener(java.lang.String clsnm) Sets the renderer by use of a class name.
void	setBgAlpha(int alpha) Set the background alpha (transparency, 0 ~ 255).
void	setBgColor(java.lang.String color) Set the background color of the chart.
void	setDateFormat(java.lang.String format) Sets the date format used by date related Chart.
void	setEngine(ChartEngine engine) Sets the chart engine.
void	setEngine(java.lang.String clsnm) Sets the chart engine by use of a class name.
void	setFgAlpha(int alpha) Set the foreground alpha (transparency, 0 ~ 255).
void	setHeight(java.lang.String h) Override super class to prepare the int height.
void	setModel(ChartModel model) Sets the chart model associated with this chart.
void	setModel(java.lang.String clsnm) Sets the model by use of a class name.
void	setOrient(java.lang.String orient) Set the chart orientation.
void	setPaneAlpha(int alpha) Set the pane alpha (transparency, 0 ~ 255).
void	setPaneColor(java.lang.String color) Set the pane color of the chart.
void	setPeriod(java.lang.String period) Sets the period used in Time Series Chart.
void	setShowLegend(boolean showLegend) whether show the chart's legend.
void	setShowTooltiptext(boolean showTooltiptext) whether show the chart's tooltip.
void	setThreeD(boolean b) Set true to show three dimensional graph (If a type of chart got no 3d peer, this is ignored).
void	setTimeZone(java.util.TimeZone tzone) Sets the time zone that this Time Series Chart belongs to, or null if the default time zone is used.
void	setTitle(java.lang.String title) Set the chart's title.
void	setType(java.lang.String type) Set the chart's type (Chart.PIE, Chart.BAR, Chart.LINE, etc.).
void	setWidth(java.lang.String w) Override super class to prepare the int width.
void	setXAxis(java.lang.String label) Set the label in xAxis.
void	setYAxis(java.lang.String label) Set the label in yAxis.
protected void	smartDrawChart() mark a draw flag to inform that this Chart needs update.

Methods inherited from class org.zkoss.zul.Imagemap

beforeChildAdded, getOuterAttrs, isChildable, onChildAdded, onChildRemoved

Methods inherited from class org.zkoss.zul.Image

getAlign, getBorder, getContent, getHover, getHspace, getInnerAttrs, getSrc, getVspace, newExtraCtrl, setAlign, setBorder, setContent, setContent, setHover, setHoverContent, setHoverContent, setHspace, setSrc, setVspace, smartUpdate

Methods inherited from class org.zkoss.zul.impl.XulElement

getAction, getActionAttrs, getAllOnClickAttrs, getContext, getCtrlKeys, getPopup, getTooltip, setAction, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip

Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent

focus, getAllOnClickAttrs, getDraggable, getDroppable, getHeight, getLeft, getMoldSclass, getRealSclass, getRealStyle, getRealStyleFlags, getSclass, getStyle, getTooltiptext, getTop, getWidth, getZclass, getZindex, getZIndex, redraw, setClass, setDraggable, setDroppable, setFocus, setLeft, setMoldSclass, setSclass, setStyle, setTooltiptext, setTop, setZclass, setZindex, setZIndex

Methods inherited from class org.zkoss.zk.ui.AbstractComponent

addAnnotation, addAnnotation, addEventHandler, addForward, addForward, addForward, addForward, addMoved, addSharedAnnotationMap, addSharedEventHandlerMap, appendAsapAttr, appendAsapAttr, appendChild, applyProperties, beforeChildRemoved, beforeParentChanged, containsVariable, detach, disableClientUpdate, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttributes, getAttributes, getChildren, getCommand, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getExtraCtrl, getFellow, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getMoldURI, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getUuid, getVariable, hasFellow, insertBefore, invalidate, isAsapRequired, isInvalidated, isListenerAvailable, isVisible, newChildren, onDrawNewChild, onPageAttached, onPageDetached, onWrongValue, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, response, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setComponentDefinition, setId, setMold, setPage, setPageBefore, setParent, setVariable, setVisible, smartUpdate, smartUpdate, smartUpdateDeferred, smartUpdateValues, toString, unsetVariable

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.zkoss.zul.api.Image

getAlign, getBorder, getContent, getHover, getHspace, getSrc, getVspace, setAlign, setBorder, setContent, setContent, setHover, setHoverContent, setHoverContent, setHspace, setSrc, setVspace

Methods inherited from interface org.zkoss.zul.impl.api.XulElement

getAction, getContext, getCtrlKeys, getPopup, getTooltip, setAction, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip

Methods inherited from interface org.zkoss.zk.ui.api.HtmlBasedComponent

focus, getHeight, getLeft, getSclass, getStyle, getTooltiptext, getTop, getWidth, getZclass, getZindex, getZIndex, setDraggable, setDroppable, setFocus, setLeft, setSclass, setStyle, setTooltiptext, setTop, setZclass, setZindex, setZIndex

Methods inherited from interface org.zkoss.zk.ui.Component

addForward, addForward, addForward, addForward, appendChild, applyProperties, containsVariable, detach, getAttribute, getAttribute, getAttributes, getAttributes, getChildren, getDefinition, getDesktop, getFellow, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getUuid, getVariable, insertBefore, invalidate, isChildable, isInvalidated, isListenerAvailable, isVisible, redraw, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, setAttribute, setAttribute, setId, setMold, setPage, setPageBefore, setParent, setVariable, setVisible, unsetVariable

Field Detail

PIE

public static final java.lang.String PIE

See Also:

Constant Field Values

RING

public static final java.lang.String RING

See Also:

Constant Field Values

BAR

public static final java.lang.String BAR

See Also:

Constant Field Values

LINE

public static final java.lang.String LINE

See Also:

Constant Field Values

AREA

public static final java.lang.String AREA

See Also:

Constant Field Values

STACKED_BAR

public static final java.lang.String STACKED_BAR

See Also:

Constant Field Values

STACKED_AREA

public static final java.lang.String STACKED_AREA

See Also:

Constant Field Values

WATERFALL

public static final java.lang.String WATERFALL

See Also:

Constant Field Values

POLAR

public static final java.lang.String POLAR

See Also:

Constant Field Values

SCATTER

public static final java.lang.String SCATTER

See Also:

Constant Field Values

TIME_SERIES

public static final java.lang.String TIME_SERIES

See Also:

Constant Field Values

STEP

public static final java.lang.String STEP

See Also:

Constant Field Values

STEP_AREA

public static final java.lang.String STEP_AREA

See Also:

Constant Field Values

HISTOGRAM

public static final java.lang.String HISTOGRAM

See Also:

Constant Field Values

CANDLESTICK

public static final java.lang.String CANDLESTICK

See Also:

Constant Field Values

HIGHLOW

public static final java.lang.String HIGHLOW

See Also:

Constant Field Values

BUBBLE

public static final java.lang.String BUBBLE

See Also:

Constant Field Values

WAFERMAP

public static final java.lang.String WAFERMAP

See Also:

Constant Field Values

GANTT

public static final java.lang.String GANTT

See Also:

Constant Field Values

WIND

public static final java.lang.String WIND

See Also:

Constant Field Values

YEAR

public static final java.lang.String YEAR

See Also:

Constant Field Values

QUARTER

public static final java.lang.String QUARTER

See Also:

Constant Field Values

MONTH

public static final java.lang.String MONTH

See Also:

Constant Field Values

WEEK

public static final java.lang.String WEEK

See Also:

Constant Field Values

DAY

public static final java.lang.String DAY

See Also:

Constant Field Values

HOUR

public static final java.lang.String HOUR

See Also:

Constant Field Values

MINUTE

public static final java.lang.String MINUTE

See Also:

Constant Field Values

SECOND

public static final java.lang.String SECOND

See Also:

Constant Field Values

MILLISECOND

public static final java.lang.String MILLISECOND

See Also:

Constant Field Values

Constructor Detail

Chart

public Chart()

Method Detail

setType

public void setType(java.lang.String type)

Set the chart's type (Chart.PIE, Chart.BAR, Chart.LINE, etc.).

Default: pie.

Specified by:

setType in interface Chart

getType

public java.lang.String getType()

Get the chart's type.

Specified by:

getType in interface Chart

setThreeD

public void setThreeD(boolean b)

Set true to show three dimensional graph (If a type of chart got no 3d peer, this is ignored).

Specified by:

setThreeD in interface Chart

isThreeD

public boolean isThreeD()

Whether a 3d chart.

Specified by:

isThreeD in interface Chart

setTitle

public void setTitle(java.lang.String title)

Set the chart's title.

Specified by:

setTitle in interface Chart

Parameters:

title - the chart's title.

getTitle

public java.lang.String getTitle()

Get the chart's title.

Specified by:

getTitle in interface Chart

setWidth

public void setWidth(java.lang.String w)

Override super class to prepare the int width.

Specified by:

setWidth in interface HtmlBasedComponent

Overrides:

setWidth in class HtmlBasedComponent

getIntWidth

public int getIntWidth()

Get the chart int width in pixel; to be used by the derived subclass.

Specified by:

getIntWidth in interface Chart

setHeight

public void setHeight(java.lang.String h)

Override super class to prepare the int height.

Specified by:

setHeight in interface HtmlBasedComponent

Overrides:

setHeight in class HtmlBasedComponent

getIntHeight

public int getIntHeight()

Get the chart int width in pixel; to be used by the derived subclass.

Specified by:

getIntHeight in interface Chart

setXAxis

public void setXAxis(java.lang.String label)

Set the label in xAxis.

Specified by:

setXAxis in interface Chart

Parameters:

label - label in xAxis.

getXAxis

public java.lang.String getXAxis()

Get the label in xAxis.

Specified by:

getXAxis in interface Chart

setYAxis

public void setYAxis(java.lang.String label)

Set the label in yAxis.

Specified by:

setYAxis in interface Chart

Parameters:

label - label in yAxis.

getYAxis

public java.lang.String getYAxis()

Get the label in yAxis.

Specified by:

getYAxis in interface Chart

setShowLegend

public void setShowLegend(boolean showLegend)

whether show the chart's legend.

Specified by:

setShowLegend in interface Chart

Parameters:

showLegend - true if want to show the legend (default to true).

isShowLegend

public boolean isShowLegend()

Check whether show the legend of the chart.

Specified by:

isShowLegend in interface Chart

setShowTooltiptext

public void setShowTooltiptext(boolean showTooltiptext)

whether show the chart's tooltip.

Specified by:

setShowTooltiptext in interface Chart

Parameters:

showTooltiptext - true if want to pop the tooltiptext (default to true).

isShowTooltiptext

public boolean isShowTooltiptext()

Check whether show the tooltiptext.

Specified by:

isShowTooltiptext in interface Chart

setPaneAlpha

public void setPaneAlpha(int alpha)

Set the pane alpha (transparency, 0 ~ 255).

Specified by:

setPaneAlpha in interface Chart

Parameters:

alpha - the transparency of pane color (0 ~ 255, default to 255 opaque).

getPaneAlpha

public int getPaneAlpha()

Get the pane alpha (transparency, 0 ~ 255, opacue).

Specified by:

getPaneAlpha in interface Chart

setPaneColor

public void setPaneColor(java.lang.String color)

Set the pane color of the chart.

Specified by:

setPaneColor in interface Chart

Parameters:

color - in #RRGGBB format (hexdecimal).

getPaneColor

public java.lang.String getPaneColor()

Get the pane color of the chart (in string as #RRGGBB). null means default.

Specified by:

getPaneColor in interface Chart

getPaneRGB

public int[] getPaneRGB()

Get the pane color in int array (0: red, 1: green, 2:blue). null means default.

Specified by:

getPaneRGB in interface Chart

setFgAlpha

public void setFgAlpha(int alpha)

Set the foreground alpha (transparency, 0 ~ 255).

Specified by:

setFgAlpha in interface Chart

Parameters:

alpha - the transparency of foreground color (0 ~ 255, default to 255 opaque).

getFgAlpha

public int getFgAlpha()

Get the foreground alpha (transparency, 0 ~ 255, opacue).

Specified by:

getFgAlpha in interface Chart

setBgAlpha

public void setBgAlpha(int alpha)

Set the background alpha (transparency, 0 ~ 255).

Specified by:

setBgAlpha in interface Chart

Parameters:

alpha - the transparency of background color (0 ~ 255, default to 255 opaque).

getBgAlpha

public int getBgAlpha()

Get the background alpha (transparency, 0 ~ 255, opacue).

Specified by:

getBgAlpha in interface Chart

setBgColor

public void setBgColor(java.lang.String color)

Set the background color of the chart.

Specified by:

setBgColor in interface Chart

Parameters:

color - in #RRGGBB format (hexdecimal).

getBgColor

public java.lang.String getBgColor()

Get the background color of the chart (in string as #RRGGBB). null means default.

Specified by:

getBgColor in interface Chart

getBgRGB

public int[] getBgRGB()

Get the background color in int array (0: red, 1: green, 2:blue). null means default.

Specified by:

getBgRGB in interface Chart

setOrient

public void setOrient(java.lang.String orient)

Set the chart orientation.

Specified by:

setOrient in interface Chart

Parameters:

orient - vertical or horizontal (default to vertical)

getOrient

public java.lang.String getOrient()

Get the chart orientation (vertical or horizontal)

Specified by:

getOrient in interface Chart

getTimeZone

public java.util.TimeZone getTimeZone()

Returns the time zone that this Time Series Chart belongs to, or null if the default time zone is used.

The default time zone is determined by TimeZones.getCurrent().

Specified by:

getTimeZone in interface Chart

setTimeZone

public void setTimeZone(java.util.TimeZone tzone)

Sets the time zone that this Time Series Chart belongs to, or null if the default time zone is used.

The default time zone is determined by TimeZones.getCurrent().

Specified by:

setTimeZone in interface Chart

getPeriod

public java.lang.String getPeriod()

Returns the period used in Time Series Chart. The value can be "millisecond", "second", "minute", "hour", "day", "week", "month", "quarter", and "year". default is "millisecond" if not specified.

Specified by:

getPeriod in interface Chart

setPeriod

public void setPeriod(java.lang.String period)

Sets the period used in Time Series Chart. The value can be "millisecond", "second", "minute", "hour", "day", "week", "month", "quarter", and "year".

Specified by:

setPeriod in interface Chart

getDateFormat

public java.lang.String getDateFormat()

Returns the date format used by date related Chart.

Specified by:

getDateFormat in interface Chart

Returns:

the date format used by date related Chart..

setDateFormat

public void setDateFormat(java.lang.String format)

Sets the date format used by date related Chart.

Specified by:

setDateFormat in interface Chart

Parameters:

format -

getModel

public ChartModel getModel()

Returns the chart model associated with this chart, or null if this chart is not associated with any chart data model.

Specified by:

getModel in interface Chart

setModel

public void setModel(ChartModel model)

Sets the chart model associated with this chart. If a non-null model is assigned, no matter whether it is the same as the previous, it will always cause re-render.

Specified by:

setModel in interface Chart

Parameters:

model - the chart model to associate, or null to dis-associate any previous model.

Throws:

UiException - if failed to initialize with the model

setModel

public void setModel(java.lang.String clsnm)
              throws java.lang.ClassNotFoundException,
                     java.lang.NoSuchMethodException,
                     java.lang.IllegalAccessException,
                     java.lang.InstantiationException,
                     java.lang.reflect.InvocationTargetException

Sets the model by use of a class name. It creates an instance automatically.

Specified by:

setModel in interface Chart

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

java.lang.IllegalAccessException

java.lang.InstantiationException

java.lang.reflect.InvocationTargetException

getEngine

public ChartEngine getEngine()
                      throws UiException

Returns the implemetation chart engine.

Specified by:

getEngine in interface Chart

Throws:

UiException - if failed to load the engine.

newChartEngine

protected ChartEngine newChartEngine()
                              throws UiException

Instantiates the default chart engine. It is called, if setEngine(org.zkoss.zul.impl.ChartEngine) is not called with non-null engine.

By default, it looks up the component attribute called chart-engine. If found, the value is assumed to be the class or the class name of the default engine (it must implement ChartEngine). If not found, UiException is thrown.

Derived class might override this method to provide your own default class.

Throws:

UiException - if failed to instantiate the engine

Since:

3.0.0

setEngine

public void setEngine(ChartEngine engine)

Sets the chart engine.

Specified by:

setEngine in interface Chart

setEngine

public void setEngine(java.lang.String clsnm)
               throws java.lang.ClassNotFoundException,
                      java.lang.NoSuchMethodException,
                      java.lang.IllegalAccessException,
                      java.lang.InstantiationException,
                      java.lang.reflect.InvocationTargetException

Sets the chart engine by use of a class name. It creates an instance automatically.

Specified by:

setEngine in interface Chart

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

java.lang.IllegalAccessException

java.lang.InstantiationException

java.lang.reflect.InvocationTargetException

getAreaListener

public ChartAreaListener getAreaListener()

Returns the renderer to render each area, or null if the default renderer is used.

Specified by:

getAreaListener in interface Chart

setAreaListener

public void setAreaListener(ChartAreaListener listener)

Sets the renderer which is used to render each area.

Note: changing a render will not cause the chart to re-render. If you want it to re-render, you could call smartDraw.

Specified by:

setAreaListener in interface Chart

Parameters:

listener - the area listener, or null to ignore it.

Throws:

UiException - if failed to initialize.

setAreaListener

public void setAreaListener(java.lang.String clsnm)
                     throws java.lang.ClassNotFoundException,
                            java.lang.NoSuchMethodException,
                            java.lang.IllegalAccessException,
                            java.lang.InstantiationException,
                            java.lang.reflect.InvocationTargetException

Sets the renderer by use of a class name. It creates an instance automatically.

Specified by:

setAreaListener in interface Chart

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

java.lang.IllegalAccessException

java.lang.InstantiationException

java.lang.reflect.InvocationTargetException

smartDrawChart

protected void smartDrawChart()

mark a draw flag to inform that this Chart needs update.

addEventListener

public boolean addEventListener(java.lang.String evtnm,
                                EventListener listener)

Description copied from interface: Component

Adds an event listener to specified event for this component. The second registration is ignored and false is returned.

You could register listener to all components in the same page by use of Page.addEventListener(java.lang.String, org.zkoss.zk.ui.event.EventListener).

Specified by:

addEventListener in interface Component

Overrides:

addEventListener in class AbstractComponent

Parameters:

evtnm - what event to listen (never null)

Returns:

whether the listener is added; false if it was added before

See Also:

Page.addEventListener(java.lang.String, org.zkoss.zk.ui.event.EventListener)

clone

public java.lang.Object clone()

Description copied from interface: Component

Clones the component. All of its children is cloned. Notice that the cloned component doesn't belong to any page, nor desktop. It doesn't have parent, either.

Specified by:

clone in interface Component

Overrides:

clone in class AbstractComponent