Package org.zkoss.chart.plotOptions
Class ColumnRangePlotOptions
- java.lang.Object
-
- org.zkoss.chart.Optionable
-
- org.zkoss.chart.plotOptions.SeriesPlotOptions
-
- org.zkoss.chart.plotOptions.ColumnRangePlotOptions
-
- All Implemented Interfaces:
Serializable
,OptionDataListener
,org.zkoss.json.JSONAware
public class ColumnRangePlotOptions extends SeriesPlotOptions
An option for column range plotAll the options in this class support
DynamicalAttribute
.- Author:
- RaymondChao
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class org.zkoss.chart.Optionable
NOT_NULL_VALUE, options
-
-
Constructor Summary
Constructors Constructor Description ColumnRangePlotOptions()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Color
getBorderColor()
Returns the color of the border surrounding each slice.Object
getBorderRadius()
Returns the border radius of the series.List<Color>
getColors()
Returns a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.RangeDataLabels
getDataLabels()
Returns the first or single option of data labels.Number
getDepth()
Returns the depth of the columns in a 3D column range chart.Color
getEdgeColor()
3D columns only.Number
getEdgeWidth()
3D columns only.Number
getGroupPadding()
Returns padding between each value groups, in x axis units.Number
getMaxPointWidth()
Returns the maximum allowed pixel width for a column, translated to the height of a bar in a bar chart.Number
getMinPointLength()
Returns the minimal height for a column or width for a bar.Number
getPointPadding()
Returns padding between each column or bar, in x axis units.Number
getPointRange()
Returns the X axis range that each point is valid for.Number
getPointWidth()
Returns a pixel value specifying a fixed width for each column or bar.boolean
isCenterInCategory()
When true, the columns will center in the category, ignoring null or missing points.boolean
isGrouping()
Returns whether to group non-stacked columns or to let them render independent of each other.protected DataLabels
newDataLabels()
Internal method for subclasses to provide specific type of data labels.void
setBorderColor(String borderColor)
Sets the color of the border surrounding each slice.void
setBorderColor(Color borderColor)
Sets the color of the border surrounding each slice.void
setBorderColor(LinearGradient borderColor)
Sets the color of the border surrounding each slice.void
setBorderColor(RadialGradient borderColor)
Sets the color of the border surrounding each slice.void
setCenterInCategory(boolean centerInCategory)
When true, the columns will center in the category, ignoring null or missing points.void
setColors(String... colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.void
setColors(List<Color> colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.void
setColors(Color... colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.void
setDepth(Number depth)
Sets the depth of the columns in a 3D column range chart.void
setEdgeColor(String color)
3D columns only.void
setEdgeColor(Color color)
3D columns only.void
setEdgeWidth(Number edgeWidth)
3D columns only.void
setGrouping(boolean grouping)
Sets whether to group non-stacked columns or to let them render independent of each other.void
setGroupPadding(Number groupPadding)
Sets padding between each value groups, in x axis units.void
setMaxPointWidth(Number maxPointWidth)
Sets the maximum allowed pixel width for a column, translated to the height of a bar in a bar chart.void
setMinPointLength(Number minPointLength)
Sets the minimal height for a column or width for a bar.void
setPointPadding(Number pointPadding)
Sets padding between each column or bar, in x axis units.void
setPointRange(Number pointRange)
Sets the X axis range that each point is valid for.void
setPointWidth(Number pointWidth)
Sets a pixel value specifying a fixed width for each column or bar.-
Methods inherited from class org.zkoss.chart.plotOptions.SeriesPlotOptions
addDataLabels, getAccessibility, getAnimation, getAnimationLimit, getBoostBlending, getBoostThreshold, getBorderWidth, getClassName, getColor, getColorAxis, getColorIndex, getColorKey, getConnectorWidth, getCropThreshold, getCursor, getCustom, getDashStyle, getDataLabelsList, getDataSorting, getDescription, getDragDrop, getFindNearestPointBy, getId, getIndex, getKeys, getLabel, getLegendSymbol, getLinecap, getLineWidth, getLinkedTo, getMarker, getName, getNeckHeight, getNeckWidth, getNegativeColor, getOnPoint, getOpacity, getPointDescriptionFormatter, getPointInterval, getPointIntervalUnit, getPointPlacement, getPointStart, getStacking, getStates, getStep, getThreshold, getTooltip, getTurboThreshold, getZoneAxis, getZones, isAllowPointSelect, isAnimation, isClip, isColorByPoint, isConnectEnds, isConnectNulls, isCrisp, isDataAsColumns, isEnableMouseTracking, isGetExtremesFromAll, isIncludeInDataExport, isRelativeXValue, isSelected, isShadow, isShowCheckbox, isShowInLegend, isSkipKeyboardNavigation, isSoftThreshold, isStacking, isStickyTracking, isVisible, setAccessibility, setAllowPointSelect, setAnimation, setAnimation, setAnimationLimit, setBoostBlending, setBoostThreshold, setBorderRadius, setBorderRadius, setBorderWidth, setCenter, setCenter, setClassName, setClip, setColor, setColor, setColor, setColor, setColorAxis, setColorAxis, setColorAxis, setColorByPoint, setColorIndex, setColorKey, setConnectEnds, setConnectNulls, setConnectorWidth, setCrisp, setCropThreshold, setCursor, setCustom, setDashStyle, setDataAsColumns, setDataLabels, setDataLabels, setDataSorting, setDescription, setDragDrop, setEnableMouseTracking, setFindNearestPointBy, setGetExtremesFromAll, setId, setIncludeInDataExport, setIndex, setKeys, setLabel, setLegendSymbol, setLinecap, setLineWidth, setLinkedTo, setMarker, setName, setNeckHeight, setNeckWidth, setNegativeColor, setNegativeColor, setNegativeColor, setNegativeColor, setOnPoint, setOpacity, setPointDescriptionFormatter, setPointInterval, setPointIntervalUnit, setPointPlacement, setPointPlacement, setPointStart, setRelativeXValue, setSelected, setShadow, setShowCheckbox, setShowInLegend, setSkipKeyboardNavigation, setSoftThreshold, setStacking, setStacking, setStates, setStep, setStickyTracking, setThreshold, setTooltip, setTurboThreshold, setVisible, setWidth, setZoneAxis, setZones, setZones
-
Methods inherited from class org.zkoss.chart.Optionable
addExtraAttr, addOptionDataListener, clearOptonDataListener, clone, containsKey, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, getAttr, getAttr, getClientState, getExtraAttr, merge, onChange, removeExtraAttr, removeKey, removeOptionDataListener, setAttr, setAttr, setAttr, setAttr, toJSONString, toString
-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.zkoss.chart.OptionDataListener
onChange
-
-
-
-
Method Detail
-
getBorderColor
public Color getBorderColor()
Returns the color of the border surrounding each slice.Default: null
- Since:
- 10.2.1.0
-
setBorderColor
public void setBorderColor(Color borderColor)
Sets the color of the border surrounding each slice.- Since:
- 10.2.1.0
-
setBorderColor
public void setBorderColor(String borderColor)
Sets the color of the border surrounding each slice.- Since:
- 10.2.1.0
-
setBorderColor
public void setBorderColor(LinearGradient borderColor)
Sets the color of the border surrounding each slice.- Since:
- 10.2.1.0
-
setBorderColor
public void setBorderColor(RadialGradient borderColor)
Sets the color of the border surrounding each slice.- Since:
- 10.2.1.0
-
getBorderRadius
public Object getBorderRadius()
Returns the border radius of the series.- Overrides:
getBorderRadius
in classSeriesPlotOptions
- Since:
- 10.2.1.0
-
isCenterInCategory
public boolean isCenterInCategory()
When true, the columns will center in the category, ignoring null or missing points. When false, space will be reserved for null or missing points.Default:
false
.- Overrides:
isCenterInCategory
in classSeriesPlotOptions
- Since:
- 10.2.1.0
-
setCenterInCategory
public void setCenterInCategory(boolean centerInCategory)
When true, the columns will center in the category, ignoring null or missing points. When false, space will be reserved for null or missing points.- Overrides:
setCenterInCategory
in classSeriesPlotOptions
- Since:
- 10.2.1.0
-
getColors
public List<Color> getColors()
Returns a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.- Since:
- 10.2.1.0
-
setColors
public void setColors(List<Color> colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.- Since:
- 10.2.1.0
-
setColors
public void setColors(String... colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.- Since:
- 10.2.1.0
-
setColors
public void setColors(Color... colors)
Sets a series specific or series type specific color set to apply instead of the globalCharts.getColors()
whenSeriesPlotOptions.setColorByPoint(boolean)
is true.- Since:
- 10.2.1.0
-
newDataLabels
protected DataLabels newDataLabels()
Description copied from class:SeriesPlotOptions
Internal method for subclasses to provide specific type of data labels.- Overrides:
newDataLabels
in classSeriesPlotOptions
-
getDataLabels
public RangeDataLabels getDataLabels()
Description copied from class:SeriesPlotOptions
Returns the first or single option of data labels.- Overrides:
getDataLabels
in classSeriesPlotOptions
-
getDepth
public Number getDepth()
Returns the depth of the columns in a 3D column range chart.Default: 25
- Overrides:
getDepth
in classSeriesPlotOptions
-
setDepth
public void setDepth(Number depth)
Sets the depth of the columns in a 3D column range chart.- Overrides:
setDepth
in classSeriesPlotOptions
-
getEdgeColor
public Color getEdgeColor()
3D columns only. The color of the edges. Similar toborderColor
, except it defaults to the same color as the column.Default:
null
- Since:
- 10.2.1.0
-
setEdgeColor
public void setEdgeColor(Color color)
3D columns only. The color of the edges. Similar toborderColor
, except it defaults to the same color as the column.Default:
null
- Since:
- 10.2.1.0
-
setEdgeColor
public void setEdgeColor(String color)
3D columns only. The color of the edges. Similar toborderColor
, except it defaults to the same color as the column.Default:
null
- Since:
- 10.2.1.0
-
getEdgeWidth
public Number getEdgeWidth()
3D columns only. Returns the width of the colored edges.Default: 1
- Since:
- 10.2.1.0
-
setEdgeWidth
public void setEdgeWidth(Number edgeWidth)
3D columns only. Sets the width of the colored edges.- Since:
- 10.2.1.0
-
isGrouping
public boolean isGrouping()
Returns whether to group non-stacked columns or to let them render independent of each other. Non-grouped columns will be laid out individually and overlap each other.Default:
true
- Since:
- 10.2.1.0
-
setGrouping
public void setGrouping(boolean grouping)
Sets whether to group non-stacked columns or to let them render independent of each other. Non-grouped columns will be laid out individually and overlap each other.Default:
true
- Since:
- 10.2.1.0
-
getGroupPadding
public Number getGroupPadding()
Returns padding between each value groups, in x axis units.Default: 0.2
- Overrides:
getGroupPadding
in classSeriesPlotOptions
- Since:
- 10.2.1.0
-
setGroupPadding
public void setGroupPadding(Number groupPadding)
Sets padding between each value groups, in x axis units.- Overrides:
setGroupPadding
in classSeriesPlotOptions
- Since:
- 10.2.1.0
-
getMaxPointWidth
public Number getMaxPointWidth()
Returns the maximum allowed pixel width for a column, translated to the height of a bar in a bar chart. This prevents the columns from becoming too wide when there is a small number of points in the chart.Default: null
- Since:
- 10.2.1.0
-
setMaxPointWidth
public void setMaxPointWidth(Number maxPointWidth)
Sets the maximum allowed pixel width for a column, translated to the height of a bar in a bar chart. This prevents the columns from becoming too wide when there is a small number of points in the chart.- Since:
- 10.2.1.0
-
getMinPointLength
public Number getMinPointLength()
Returns the minimal height for a column or width for a bar. By default, 0 values are not shown. To visualize a 0 (or close to zero) point, set the minimal point length to a pixel value like 3. In stacked column charts, minPointLength might not be respected for tightly packed values.Default: 0
- Since:
- 10.2.1.0
-
setMinPointLength
public void setMinPointLength(Number minPointLength)
Sets the minimal height for a column or width for a bar. By default, 0 values are not shown. To visualize a 0 (or close to zero) point, set the minimal point length to a pixel value like 3. In stacked column charts, minPointLength might not be respected for tightly packed values.- Since:
- 10.2.1.0
-
getPointPadding
public Number getPointPadding()
Returns padding between each column or bar, in x axis units.Default:
0.1
- Since:
- 10.2.1.0
-
setPointPadding
public void setPointPadding(Number pointPadding)
Sets padding between each column or bar, in x axis units. 'pointPadding padding between each column or bar, in x axis units.- Since:
- 10.2.1.0
-
getPointRange
public Number getPointRange()
Returns the X axis range that each point is valid for. This determines the width of the column. On a categorized axis, the range will be 1 by default (one category unit). On linear and datetime axes, the range will be computed as the distance between the two closest data points.Default: null
- Since:
- 10.2.1.0
-
setPointRange
public void setPointRange(Number pointRange)
Sets the X axis range that each point is valid for. This determines the width of the column. On a categorized axis, the range will be 1 by default (one category unit). On linear and datetime axes, the range will be computed as the distance between the two closest data points.- Since:
- 10.2.1.0
-
getPointWidth
public Number getPointWidth()
Returns a pixel value specifying a fixed width for each column or bar. Whennull
, the width is calculated from thepointPadding
andgroupPadding
.Default: null
- Since:
- 10.2.1.0
-
setPointWidth
public void setPointWidth(Number pointWidth)
Sets a pixel value specifying a fixed width for each column or bar. Whennull
, the width is calculated from thepointPadding
andgroupPadding
.- Since:
- 10.2.1.0
-
-