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, org.zkoss.zk.ui.Component, org.zkoss.zk.ui.sys.ComponentCtrl

public class Chart
extends Imagemap

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
pie	PieModel	o
ring	PieModel	x
bar	CategoryModel	o
line	CategoryModel or XYModel	o
area	CategoryModel or XYModel	x
stacked_bar	CategoryModel	o
stacked_area	CategoryModel or XYModel	x
waterfall	CategoryModel	x
polar	XYModel	x
scatter	XYModel	x
time_series	XYModel	x
polar	XYModel	x
step_area	XYModel	x
step	XYModel	x

Author:

henrichen

See Also:

Serialized Form

Nested Class Summary

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

Image.ExtraCtrl

Field Summary

static java.lang.String	AREA
static java.lang.String	BAR
static java.lang.String	CANDLESTICK
static java.lang.String	DAY
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	WATERFALL
static java.lang.String	WEEK
static java.lang.String	YEAR

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

RS_NO_DISPLAY, RS_NO_HEIGHT, RS_NO_WIDTH

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

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).
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.
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	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

getOuterAttrs, insertBefore, isChildable

Methods inherited from class org.zkoss.zul.Image

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

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

getAction, getAllOnClickAttrs, getContext, getPopup, getTooltip, setAction, setContext, setPopup, setTooltip

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

addEventListener, appendAsapAttr, focus, getDraggable, getDroppable, getHeight, getLeft, getRealStyle, getRealStyleFlags, getSclass, getStyle, getTooltiptext, getTop, getWidth, getZIndex, isAsapRequired, removeEventListener, setClass, setDraggable, setDroppable, setLeft, setSclass, setStyle, setTooltiptext, setTop, setZIndex

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

addAnnotation, addAnnotation, addEventHandler, addSharedAnnotationMap, addSharedEventHandlerMap, appendChild, applyProperties, clone, containsVariable, detach, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttributes, getAttributes, getChildren, getDefinition, getDesktop, getEventHandler, getExtraCtrl, getFellow, getFellowIfAny, getId, getListenerIterator, getMold, getMoldURI, getNamespace, getPage, getParent, getPropagatee, getRoot, getSpaceOwner, getUuid, getVariable, invalidate, isListenerAvailable, isVisible, onChildAdded, onChildRemoved, onDrawNewChild, onWrongValue, redraw, removeAttribute, removeAttribute, removeChild, response, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setComponentDefinition, setId, setMold, setPage, setParent, setVariable, setVisible, smartUpdate, smartUpdate, toString, unsetVariable

Methods inherited from class java.lang.Object

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

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

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.).

getType

public java.lang.String getType()

Get the chart's type.

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).

isThreeD

public boolean isThreeD()

Whether a 3d chart.

setTitle

public void setTitle(java.lang.String title)

Set the chart's title.

Parameters:

title - the chart's title.

getTitle

public java.lang.String getTitle()

Get the chart's title.

setWidth

public void setWidth(java.lang.String w)

Override super class to prepare the int width.

Overrides:

setWidth in class org.zkoss.zk.ui.HtmlBasedComponent

getIntWidth

public int getIntWidth()

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

setHeight

public void setHeight(java.lang.String h)

Override super class to prepare the int height.

Overrides:

setHeight in class org.zkoss.zk.ui.HtmlBasedComponent

getIntHeight

public int getIntHeight()

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

setXAxis

public void setXAxis(java.lang.String label)

Set the label in xAxis.

Parameters:

label - label in xAxis.

getXAxis

public java.lang.String getXAxis()

Get the label in xAxis.

setYAxis

public void setYAxis(java.lang.String label)

Set the label in yAxis.

Parameters:

label - label in yAxis.

getYAxis

public java.lang.String getYAxis()

Get the label in yAxis.

setShowLegend

public void setShowLegend(boolean showLegend)

whether show the chart's legend.

Parameters:

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

isShowLegend

public boolean isShowLegend()

Check whether show the legend of the chart.

setShowTooltiptext

public void setShowTooltiptext(boolean showTooltiptext)

whether show the chart's tooltip.

Parameters:

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

isShowTooltiptext

public boolean isShowTooltiptext()

Check whether show the tooltiptext.

setPaneAlpha

public void setPaneAlpha(int alpha)

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

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).

setPaneColor

public void setPaneColor(java.lang.String color)

Set the pane color of the 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.

getPaneRGB

public int[] getPaneRGB()

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

setFgAlpha

public void setFgAlpha(int alpha)

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

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).

setBgAlpha

public void setBgAlpha(int alpha)

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

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).

setBgColor

public void setBgColor(java.lang.String color)

Set the background color of the 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.

getBgRGB

public int[] getBgRGB()

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

setOrient

public void setOrient(java.lang.String orient)

Set the chart orientation.

Parameters:

orient - vertical or horizontal (default to vertical)

getOrient

public java.lang.String getOrient()

Get the chart orientation (vertical or horizontal)

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().

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().

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.

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".

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.

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.

Parameters:

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

Throws:

org.zkoss.zk.ui.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.InstantiationException,
                     java.lang.reflect.InvocationTargetException

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

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

java.lang.InstantiationException

java.lang.reflect.InvocationTargetException

getEngine

public ChartEngine getEngine()

Returns the implemetation chart engine.

setEngine

public void setEngine(ChartEngine engine)

Sets the chart engine.

setEngine

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

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

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

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.

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.

Parameters:

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

Throws:

org.zkoss.zk.ui.UiException - if failed to initialize.

setAreaListener

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

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

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

java.lang.InstantiationException

java.lang.reflect.InvocationTargetException

smartDrawChart

protected void smartDrawChart()

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