ChartHandle (OpenXLS Java Spreadsheet SDK 11.0.4 API)

java.lang.Object
- io.starter.OpenXLS.ChartHandle

All Implemented Interfaces:

ChartConstants
```
public class ChartHandle
extends Object
implements ChartConstants
```
Chart Handle allows for manipulation of Charts within a WorkBook.
Allows for run-time modification of Chart titles, labels, categories, and data Cells.
Modification of Chart data cells allows you to completely modify the data shown on the Chart.

To create a new chart and add to a worksheet, use: ChartHandle.createNewChart(sheet, charttype, chartoptions).

To Obtain an array of existing chart handles, use
WorkBookHandle.getCharts()
or WorkBookHandle.getCharts(chart title) Starter Inc.

See Also:

WorkBookHandle

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class ChartHandle.ChartOptions
Chart Options.

Nested Classes
Modifier and Type	Class and Description
`static class`	`ChartHandle.ChartOptions` Chart Options.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`AREA`
`static int`	`AREACHART`
`static int`	`BAR`
`static int`	`BARCHART`
`static int`	`BUBBLE`
`static int`	`BUBBLECHART`
`static int`	`COL`
`static int`	`COLCHART`
`static int`	`CONE`
`static int`	`CONEBAR`
`static int`	`CONEBARCHART`
`static int`	`CONECHART`
`static int`	`CYLINDER`
`static int`	`CYLINDERBAR`
`static int`	`CYLINDERBARCHART`
`static int`	`CYLINDERCHART`
`static int`	`DOUGHNUT`
`static int`	`DOUGHNUTCHART`
`static int`	`HEIGHT`
`static int`	`LINE`
`static int`	`LINECHART`
`static int`	`OFPIECHART`
`static int`	`PIE`
`static int`	`PIECHART`
`static int`	`PYRAMID`
`static int`	`PYRAMIDBAR`
`static int`	`PYRAMIDBARCHART`
`static int`	`PYRAMIDCHART`
`static int`	`RADAR`
`static int`	`RADARAREA`
`static int`	`RADARAREACHART`
`static int`	`RADARCHART`
`static int`	`SCATTER`
`static int`	`SCATTERCHART`
`static int`	`STOCKCHART`
`static int`	`SURFACE`
`static int`	`SURFACECHART`
`protected WorkBookHandle`	`wbh`
`static int`	`WIDTH`
`static int`	`X`
`static int`	`XAXIS`
`static int`	`XVALAXIS`
`static int`	`Y`
`static int`	`YAXIS`
`static int`	`ZAXIS`

Fields inherited from interface io.starter.formats.XLS.charts.ChartConstants
SHAPECOLUMN, SHAPECONE, SHAPECONETOMAX, SHAPECYLINDER, SHAPEDEFAULT, SHAPEPYRAMID, SHAPEPYRAMIDTOMAX

Constructor Summary

Constructors
Constructor and Description

ChartHandle(Chart c, WorkBookHandle wb)
Constructor which creates a new ChartHandle from an existing Chart Object

Constructors
Constructor and Description
`ChartHandle(Chart c, WorkBookHandle wb)` Constructor which creates a new ChartHandle from an existing Chart Object

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addAllSeries(String[] valueRanges, String[] legendCells, String[] bubbleSizeRanges, String categoryRange)` updates (replaces) every Chart Series (bar, line or wedge on the Chart) with the data from the array of values, legends, bubble sizes (optional) and category range.
`void`	`addChartEmbed(String[] ce)` sets external information linked to or "embedded" in this OOXML chart; can be a chart user shape, an image ...
`ChartSeriesHandle`	`addSeriesRange(CellHandle legendCell, CellRange categoryRange, CellRange seriesRange, CellRange bubbleRange)` Adds a new Series to the chart via CellHandles and CellRange Objects.
`ChartSeriesHandle`	`addSeriesRange(CellHandle legendCell, CellRange categoryRange, CellRange seriesRange, CellRange bubbleRange, int nChart)` Adds a new Series to the chart via CellHandles and CellRange Objects.
`ChartSeriesHandle`	`addSeriesRange(String legendCell, String categoryRange, String seriesRange, String bubbleRange)` Adds a new Series to the chart.
`ChartSeriesHandle`	`addSeriesRange(String legendCell, String categoryRange, String seriesRange, String bubbleRange, int nChart)` Adds a new Series to the chart.
`void`	`appendRowCategoryToChart()` Append a row of categories to the bottom of the chart.
`void`	`appendRowCategoryToChart(int nChart)` Append a row of categories to the bottom of the chart.
`ChartSeriesHandle`	`appendRowSeriesToChart()` Appends a series one row below the last series in the chart.
`ChartSeriesHandle`	`appendRowSeriesToChart(int nChart)` Appends a series one row below the last series in the chart for the desired chart
`boolean`	`changeCategoryRange(String originalrange, String newrange)` Change the Cell Range representing the Categories in the Chart.
`boolean`	`changeSeriesRange(String originalrange, String newrange)` Change the Cell Range referenced by one of the Series (a bar, line or wedge of data) in the Chart.
`boolean`	`changeTextValue(String originalval, String newval)` Change the value of a Chart object.
`static ChartHandle`	`createNewChart(WorkSheetHandle sheet, int chartType, EnumSet<ChartHandle.ChartOptions> options)` Static method to create a new chart on WorkSheet sheet of type chartType with chart Options options After creating, you can set the chart title via ChartHandle.setTitle and Position via ChartHandle.setRelativeBounds (row/col-based) or ChartHandle.setCoords (pixel-based) as well as several other customizations possible
`ChartSeriesHandle[]`	`getAllChartSeriesHandles()` Returns an array of ChartSeriesHandle Objects, one for each bar, line or wedge of data.
`ChartSeriesHandle[]`	`getAllChartSeriesHandles(int nChart)` Returns an array of ChartSeriesHandle Objects for the desired chart, one for each bar, line or wedge of data.
`String`	`getAllSeriesDataJSON()` returns a JSON representation of all Series Data (Legend, Categogies, Series Values) for the chart This is an internal method that is not useful to the end user.
`Axis`	`getAxis(int type)`
`boolean`	`getAxisAutomaticScale()` Returns true if the Y Axis (Value axis) is set to automatic scale
`boolean`	`getAxisAutomaticScale(int axisType)` Returns true if the desired Value axis is set to automatic scale
`Font`	`getAxisFont()` return the Font associated with the Chart Axes
`int`	`getAxisMajorUnit()` Returns the major tick unit of the Y Axis (Value Axis)
`int`	`getAxisMajorUnit(int axisType)` Returns the major tick unit of the desired Value axis
`double`	`getAxisMaxScale()` Returns the maximum value of the Y Axis (Value Axis) scale
`double`	`getAxisMaxScale(int axisType)` Returns the maximum scale value of the desired Value axis
`int`	`getAxisMinorUnit()` Returns the minor tick unit of the Y Axis (Value Axis)
`int`	`getAxisMinorUnit(int axisType)` Returns the minor tick unit of the desired Value axis
`double`	`getAxisMinScale()` Returns the minimum value of the Y Axis (Value Axis) scale
`double`	`getAxisMinScale(int axisType)` Returns the minimum scale value of the the desired Value axis
`int`	`getAxisPlacement(int Axis)` Returns the Axis Label Placement or position as an int
`short[]`	`getBounds()` returns the coordinates or bounds (position, width and height) of this chart in pixels
`String[]`	`getCategories()` Returns an ordered array of strings representing all the category ranges in the chart.
`byte[]`	`getChartBytes()` Get the Chart's bytes This is an internal method that is not useful to the end user.
`String`	`getChartDrawingOOXML(int id)` generates the OOXML specific for DrawingML, specifying offsets and identifying the chart object.
`ArrayList<?>`	`getChartEmbeds()` returns the drawingml file name which defines the userShape (if any) a userShape is a drawing or shape ontop of a chart associated with this chart
`String`	`getChartFontRecsXML()` returns Chart-specific Font Records in XML form
`String`	`getChartFontsXML()` Return non-axis Chart font ids in XML form
`ChartSeriesHandle`	`getChartSeriesHandle(int idx)` Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the specified Series index
`ChartSeriesHandle`	`getChartSeriesHandle(String seriesRange)` Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the specified Series range
`ChartSeriesHandle`	`getChartSeriesHandleByName(String legend)` Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the Series specified by label (legend)
`int`	`getChartType()` Return an int corresponding to this ChartHandle's Chart Type for the default chart To see possible Chart Types, view the public static int's in ChartHandle.
`int`	`getChartType(int nChart)` Return an int corresponding to this ChartHandle's Chart Type for the specified chart To see possible Chart Types, view the public static int's in ChartHandle.
`short`	`getColOffset()` returns the offset within the column in pixels
`short[]`	`getCoords()` returns the coordinates (position, width and height) of this chart in Excel size units
`org.json.JSONObject`	`getCurrentSeries()` retrieves current series and axis scale info in JSONObject form used upon chart updating This is an internal method that is not useful to the end user.
`String`	`getDataRangeJSON()` returns the data range used by the chart
`int[]`	`getEncompassingDataRange()`
`static int[]`	`getEncompassingDataRange(org.json.JSONObject jsonDataRange)` returns the encompassing range for this chart, or null if the chart data is too complex to represent
`int`	`getId()` returns the ordinal id associated with the underlying Chart Object
`protected String`	`getJavaScript()` returns the svg for javascript for highlight and restore
`String`	`getJSON()` returs the JSON representation of this chart, based upon Dojo-charting-specifics
`String`	`getOOXML(int rId)` Generates OOXML (chartML) for this chart object.
`int`	`getPlotAreaBgColor()` return the background color of this chart's Plot Area as an int
`String`	`getPlotAreaBgColorStr()`
`short[]`	`getRelativeBounds()` get the bounds of the chart using coordinates relative to row/cols and their offsets
`byte[]`	`getSerialBytes()`
`String[]`	`getSeries()` Returns an ordered array of strings representing all the series ranges in the Chart.
`org.json.JSONArray`	`getSeriesJSON()` retrieves the saved Series JSON for comparisons This is an internal method that is not useful to the end user.
`Boundsheet`	`getSheet()` returns the underlhying Sheet Object this Chart is attached to For Internal Use
`String`	`getSVG()` TODO: Less Common Charts: STOCK RADAR SURFACE COLUMN- 3D, CONE, CYLINDER, PYRAMID BAR- 3D, CONE, CYLINDER, PYRAMID 3D PIE 3D LINE 3D AREA LINE CHART APPEARS THAT STARTS AND ENDS A BIT TOO EARLY ***************** Z Axis CHART OPTIONS: STACKED CLUSTERED
`String`	`getSVG(double scale)` /** Take current Chart object and return the SVG code necessary to define it, scaled to the desired percentage e.g.
`String`	`getThreeDXML()`
`String`	`getTitle()` Returns the title of the Chart
`Font`	`getTitleFont()` returns the Font associated with the Chart Title
`WorkBook`	`getWorkBook()`
`WorkBookHandle`	`getWorkBookHandle()`
`WorkSheetHandle`	`getWorkSheetHandle()`
`String`	`getXAxisLabel()` returns the X axis Title
`String`	`getXML()` returns an XML representation of this chart
`String`	`getYAxisLabel()` returns the Y axis Title
`String`	`getZAxisLabel()` returns the Z axis Title, if any
`boolean`	`hasDataLegend()` returns true if Chart has a Data Legend Key showing
`protected void`	`inputJSONObject(org.json.JSONObject source, org.json.JSONObject input)` utility to add a JSON object This is an internal method that is not useful to the end user.
`boolean`	`is100PercentStacked()`
`boolean`	`isClustered()`
`boolean`	`isStacked()`
`boolean`	`isThreeD()`
`boolean`	`isThreeD(int nChart)`
`void`	`make100PercentStacked(int nChart)` Deprecated.
`void`	`make100PercentStacked3D(int nChart)` Deprecated.
`void`	`make3D()` Deprecated. use setChartType(chartType, 0, is3d, isStacked, is100PercentStacked) instead
`void`	`make3D(int nChart)` Deprecated. use setChartType(chartType, nChart, is3d, isStacked, is100%Stacked) instead
`void`	`makeClustered3D(int nChart)` Deprecated.
`void`	`makeExploded()` Deprecated.
`void`	`makeExploded3D(int nChart)` Deprecated.
`void`	`makeStacked(int nChart)` Deprecated.
`void`	`makeStacked3D(int nChart)` makes this Chart Stacked with a 3D Effect sets the group of options necessary to create a Stacked 3D chart For Chart Types: BAR, COL, AREA
`void`	`parseOOXML(InputStream ii)` defines this chart object based on a Chart ML (OOXML) input Stream (root element=c:chartSpace) This is an internal method that is not useful to the end user.
`void`	`parseXML(WorkSheetHandle sht, org.xmlpull.v1.XmlPullParser xpp, HashMap<?,?> maps)` given a XmlPullParser positioned at the chart element, parse all chart elements to create desired chart
`void`	`removeAxis(int axisType)` removes the desired Axis from the Chart
`void`	`removeLegend()`
`void`	`removeSeries(int index)` remove the Series (bar, line or wedge) at the desired index
`void`	`removeSeries(int index, int nChart)` remove the Series (bar, line or wedge) at the desired index
`void`	`resetFonts()` resets all fonts in the chart to the default font of the workbook
`void`	`setAxisAutomaticScale(boolean b)` Sets the automatic scale option on or off for the Y Axis (Value axis)
`void`	`setAxisAutomaticScale(int axisType, boolean b)` Sets the automatic scale option on or off for the desired Value axis
`void`	`setAxisFont(Font f)` set the font for all axes on the Chart
`void`	`setAxisFont(String name, int height, boolean bold, boolean italic, boolean underline)` set the font for all axes on the chart
`void`	`setAxisMax(int MaxValue)` Sets the maximum value of the Y Axis (Value Axis) Scale
`void`	`setAxisMax(int axisType, int MaxValue)` Sets the maximum scale value of the desired Value axis
`void`	`setAxisMin(int MinValue)` Sets the minimum value of the Y Axis (Value Axis) Scale
`void`	`setAxisMin(int axisType, int MinValue)` Sets the minimum scale value of the desired Value axis
`void`	`setAxisOption(int axisType, String op, String val)` sets an option for this axis
`void`	`setAxisPlacement(int Axis, int Placement)` Sets the Axis labels position or placement to the desired value (these match Excel placement options)
`void`	`setAxisTitle(int axisType, String ttl)` sets or removes the axis title
`void`	`setBounds(short[] bounds)` sets the coordinates or bounds (position, width and height) of this chart in pixels
`void`	`setChartFont(String type, String val)` Set non-axis chart font id for title, default, etc For Internal Use Only
`void`	`setChartOption(String op, String val)` Method for setting Chart-Type-specific options in a generic fashion e.g.
`void`	`setChartType(int chartType)` Sets the Chart type to the specified basic type (no 3d, no stacked ...) To see possible Chart Types, view the public static int's in ChartHandle.
`void`	`setChartType(int chartType, int nChart)` Sets the basic chart type (no 3d, stacked...) for multiple or overlay Charts.
`void`	`setChartType(int chartType, int nChart, EnumSet<ChartHandle.ChartOptions> options)` Sets the Chart type to the specified type (no 3d, no stacked ...) To see possible Chart Types, view the public static int's in ChartHandle.
`void`	`setCoords(short[] coords)` sets the coordinates (position, width and height) for this chart in Excel size units
`void`	`setDataLabel(String type, boolean bShowLegendKey)`
`protected void`	`setDimensionsRecord()` set the chart DIMENSIONS record based on the series ranges in the chart APPEARS THAT for charts, the DIMENSIONS record merely notes the range of values: 0, #points in series, 0, #series
`void`	`setEditMovement(String editMovement)` Specifies how to resize or move this Chart upon edit This is an internal method that is not useful to the end user.
`void`	`setMarkerFormat(int imf)` set the marker format style for this chart one of: 0 = no marker 1 = square 2 = diamond 3 = triangle 4 = X 5 = star 6 = Dow-Jones 7 = standard deviation 8 = circle 9 = plus sign For Chart Types: LINE, SCATTER
`void`	`setOOXMLName(String name)` set the Excel 7/OOXML-specific name for this chart
`void`	`setPlotAreaBgColor(int bg)` sets the Plot Area background color
`void`	`setRelativeBounds(short[] bounds)` sets the bounds of the chart using coordinates relative to row/cols and their offsets
`ChartSeriesHandle`	`setSeries(int index, String legendCell, String categoryRange, String seriesRange, String bubbleRange)` Changes or adds a Series to the chart via Series Index.
`ChartSeriesHandle`	`setSeries(int index, String legendCell, String legendText, String categoryRange, String seriesRange, String bubbleRange)` Changes or adds a Series to the chart via Series Index.
`ChartSeriesHandle`	`setSeries(int index, String legendCell, String legendText, String categoryRange, String seriesRange, String bubbleRange, int nChart)` Changes or adds a Series to the desired Chart (either default or overlay) via Series Index.
`void`	`setSeriesJSON(org.json.JSONArray s)` sets the saved Series JSON This is an internal method that is not useful to the end user.
`void`	`setTitle(String title)` Sets the title of the Chart
`void`	`setTitleFont(Font f)` set the font for the Chart Title
`void`	`setTitleFont(String name, int height, boolean bold, boolean italic, boolean underline)` set the font for the chart title
`void`	`setXAxisLabel(String xTitle)` Sets the XAxisTitle
`void`	`setYAxisLabel(String yTitle)` Sets the Y axis Title
`void`	`setZAxisLabel(String zTitle)` set the Z AxisTitle
`void`	`showDataTable(boolean bShow)` shows or removes the Data Table for this chart
`void`	`showLegend(boolean bShow, boolean vertical)` shows or hides the Chart legend key
`String`	`toString()` returns the string representation of this ChartHandle
`void`	`WriteMainChartRecs(String fName)` debugging utility remove when done

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - BARCHART
```
public static final int BARCHART
```
    See Also:
    
    Constant Field Values
  - COLCHART
```
public static final int COLCHART
```
    See Also:
    
    Constant Field Values
  - LINECHART
```
public static final int LINECHART
```
    See Also:
    
    Constant Field Values
  - PIECHART
```
public static final int PIECHART
```
    See Also:
    
    Constant Field Values
  - AREACHART
```
public static final int AREACHART
```
    See Also:
    
    Constant Field Values
  - SCATTERCHART
```
public static final int SCATTERCHART
```
    See Also:
    
    Constant Field Values
  - RADARCHART
```
public static final int RADARCHART
```
    See Also:
    
    Constant Field Values
  - SURFACECHART
```
public static final int SURFACECHART
```
    See Also:
    
    Constant Field Values
  - DOUGHNUTCHART
```
public static final int DOUGHNUTCHART
```
    See Also:
    
    Constant Field Values
  - BUBBLECHART
```
public static final int BUBBLECHART
```
    See Also:
    
    Constant Field Values
  - OFPIECHART
```
public static final int OFPIECHART
```
    See Also:
    
    Constant Field Values
  - PYRAMIDCHART
```
public static final int PYRAMIDCHART
```
    See Also:
    
    Constant Field Values
  - CYLINDERCHART
```
public static final int CYLINDERCHART
```
    See Also:
    
    Constant Field Values
  - CONECHART
```
public static final int CONECHART
```
    See Also:
    
    Constant Field Values
  - PYRAMIDBARCHART
```
public static final int PYRAMIDBARCHART
```
    See Also:
    
    Constant Field Values
  - CYLINDERBARCHART
```
public static final int CYLINDERBARCHART
```
    See Also:
    
    Constant Field Values
  - CONEBARCHART
```
public static final int CONEBARCHART
```
    See Also:
    
    Constant Field Values
  - RADARAREACHART
```
public static final int RADARAREACHART
```
    See Also:
    
    Constant Field Values
  - STOCKCHART
```
public static final int STOCKCHART
```
    See Also:
    
    Constant Field Values
  - BAR
```
public static final int BAR
```
    See Also:
    
    Constant Field Values
  - COL
```
public static final int COL
```
    See Also:
    
    Constant Field Values
  - LINE
```
public static final int LINE
```
    See Also:
    
    Constant Field Values
  - PIE
```
public static final int PIE
```
    See Also:
    
    Constant Field Values
  - AREA
```
public static final int AREA
```
    See Also:
    
    Constant Field Values
  - SCATTER
```
public static final int SCATTER
```
    See Also:
    
    Constant Field Values
  - RADAR
```
public static final int RADAR
```
    See Also:
    
    Constant Field Values
  - SURFACE
```
public static final int SURFACE
```
    See Also:
    
    Constant Field Values
  - DOUGHNUT
```
public static final int DOUGHNUT
```
    See Also:
    
    Constant Field Values
  - BUBBLE
```
public static final int BUBBLE
```
    See Also:
    
    Constant Field Values
  - RADARAREA
```
public static final int RADARAREA
```
    See Also:
    
    Constant Field Values
  - PYRAMID
```
public static final int PYRAMID
```
    See Also:
    
    Constant Field Values
  - CYLINDER
```
public static final int CYLINDER
```
    See Also:
    
    Constant Field Values
  - CONE
```
public static final int CONE
```
    See Also:
    
    Constant Field Values
  - PYRAMIDBAR
```
public static final int PYRAMIDBAR
```
    See Also:
    
    Constant Field Values
  - CYLINDERBAR
```
public static final int CYLINDERBAR
```
    See Also:
    
    Constant Field Values
  - CONEBAR
```
public static final int CONEBAR
```
    See Also:
    
    Constant Field Values
  - XAXIS
```
public static final int XAXIS
```
    See Also:
    
    Constant Field Values
  - YAXIS
```
public static final int YAXIS
```
    See Also:
    
    Constant Field Values
  - ZAXIS
```
public static final int ZAXIS
```
    See Also:
    
    Constant Field Values
  - XVALAXIS
```
public static final int XVALAXIS
```
    See Also:
    
    Constant Field Values
  - X
```
public static final int X
```
    See Also:
    
    Constant Field Values
  - Y
```
public static final int Y
```
    See Also:
    
    Constant Field Values
  - WIDTH
```
public static final int WIDTH
```
    See Also:
    
    Constant Field Values
  - HEIGHT
```
public static final int HEIGHT
```
    See Also:
    
    Constant Field Values
  - wbh
```
protected WorkBookHandle wbh
```
- Constructor Detail
  - ChartHandle
```
public ChartHandle(Chart c,
                   WorkBookHandle wb)
```
    Constructor which creates a new ChartHandle from an existing Chart Object
    
    Parameters:
    
    Chart - c - the source Chart object
    
    WorkBookHandle - wb - the parent WorkBookHandle
- Method Detail
  - getTitle
```
public String getTitle()
```
    Returns the title of the Chart
    
    Returns:
    
    String title of the Chart
  - setTitle
```
public void setTitle(String title)
```
    Sets the title of the Chart
    
    Parameters:
    
    String - title - Chart title
  - getDataRangeJSON
```
public String getDataRangeJSON()
```
    returns the data range used by the chart
    
    Returns:
  - getEncompassingDataRange
```
public int[] getEncompassingDataRange()
```
  - getEncompassingDataRange
```
public static int[] getEncompassingDataRange(org.json.JSONObject jsonDataRange)
```
    returns the encompassing range for this chart, or null if the chart data is too complex to represent
    
    Parameters:
    
    jsonDataRange -
    
    Returns:
  - getId
```
public int getId()
```
    returns the ordinal id associated with the underlying Chart Object
    
    Returns:
    
    int chart id
    
    See Also:
    
    WorkBookHandle.getChartById
  - toString
```
public String toString()
```
    returns the string representation of this ChartHandle
    
    Overrides:
    
    toString in class Object
  - getSeries
```
public String[] getSeries()
```
    Returns an ordered array of strings representing all the series ranges in the Chart.
    Each series can only represent one bar, line or wedge of data.
    
    Returns:
    
    String[] each item being a Cell Range representing one bar, line or wedge of data in the Chart
    
    See Also:
    
    ChartHandle.getCategories
  - getCategories
```
public String[] getCategories()
```
    Returns an ordered array of strings representing all the category ranges in the chart.
    This vector corresponds to the getSeries() method so will often contain duplicates, as while the series data changes frequently, category data is the same throughout the chart.
    
    Returns:
    
    String[] each item being a Cell Range representing the Category Data
    
    See Also:
    
    ChartHandle.getSeries
  - getAllChartSeriesHandles
```
public ChartSeriesHandle[] getAllChartSeriesHandles()
```
    Returns an array of ChartSeriesHandle Objects, one for each bar, line or wedge of data.
    
    Returns:
    
    ChartSeriesHandle[] Array of ChartSeriesHandle Objects representing Chart Series Data (Series and Categories)
    
    See Also:
    
    ChartSeriesHandle
  - getAllChartSeriesHandles
```
public ChartSeriesHandle[] getAllChartSeriesHandles(int nChart)
```
    Returns an array of ChartSeriesHandle Objects for the desired chart, one for each bar, line or wedge of data.
    A chart number of 0 means the default chart, 1-9 indicate series for overlay charts
    NOTE: using this method returns the series for the desired chart ONLY
    You MUST use the corresponding removeSeries(index, nChart) when removing series to properly match the series index. Otherwise a mismatch will occur.
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    ChartSeriesHandle[] Array of ChartSeriesHandle Objects representing Chart Series Data (Series and Categories)
    
    See Also:
    
    ChartSeriesHandle
  - getChartSeriesHandle
```
public ChartSeriesHandle getChartSeriesHandle(String seriesRange)
```
    Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the specified Series range
    
    Parameters:
    
    String - seriesRange - For example, "Sheet1!A12:A21"
    
    Returns:
    
    ChartSeriesHandle
    
    See Also:
    
    ChartSeriesHandle
  - getChartSeriesHandle
```
public ChartSeriesHandle getChartSeriesHandle(int idx)
```
    Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the specified Series index
    
    Parameters:
    
    int - idx - the index (0 based) of the series
    
    Returns:
    
    ChartSeriesHandle
    
    See Also:
    
    ChartSeriesHandle
  - getChartSeriesHandleByName
```
public ChartSeriesHandle getChartSeriesHandleByName(String legend)
```
    Get the ChartSeriesHandle representing Chart Series Data (Series and Categories) for the Series specified by label (legend)
    
    Parameters:
    
    String - legend - label for the desired series
    
    Returns:
    
    ChartSeriesHandle
    
    See Also:
    
    ChartSeriesHandle
  - setAxisTitle
```
public void setAxisTitle(int axisType,
                         String ttl)
```
    sets or removes the axis title
    
    Parameters:
    
    axisType - one of: XAXIS, YAXIS, ZAXIS
    
    ttl - String new title or null to remove
  - getYAxisLabel
```
public String getYAxisLabel()
```
    returns the Y axis Title
    
    Returns:
    
    String title
  - setYAxisLabel
```
public void setYAxisLabel(String yTitle)
```
    Sets the Y axis Title
    
    Parameters:
    
    String - yTitle - new Y Axis title
  - getXAxisLabel
```
public String getXAxisLabel()
```
    returns the X axis Title
    
    Returns:
    
    String title
  - setXAxisLabel
```
public void setXAxisLabel(String xTitle)
```
    Sets the XAxisTitle
    
    Parameters:
    
    String - xTitle - new X Axis title
  - getZAxisLabel
```
public String getZAxisLabel()
```
    returns the Z axis Title, if any
    
    Returns:
    
    String Title
  - setZAxisLabel
```
public void setZAxisLabel(String zTitle)
```
    set the Z AxisTitle
    
    Parameters:
    
    String - zTitle - new Z Axis Title
  - setAxisAutomaticScale
```
public void setAxisAutomaticScale(int axisType,
                                  boolean b)
```
    Sets the automatic scale option on or off for the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    Automatic Scaling automatically sets the scale maximum, minimum and tick units upon data changes, and is the default setting for charts
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    boolean - b - true if set Automatic scaling on, false otherwise
    
    See Also:
    
    setAxisAutomaticScale(boolean b)
  - getAxisMinScale
```
public double getAxisMinScale(int axisType)
```
    Returns the minimum scale value of the the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    Returns:
    
    int Miminum Scale value for the desired axis
    
    See Also:
    
    getAxisMinScale()
  - getAxisMaxScale
```
public double getAxisMaxScale(int axisType)
```
    Returns the maximum scale value of the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    Returns:
    
    int - Maximum Scale value for the desired axis
    
    See Also:
    
    getAxisMaxScale()
  - getAxisMajorUnit
```
public int getAxisMajorUnit(int axisType)
```
    Returns the major tick unit of the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    Returns:
    
    int major tick unit
    
    See Also:
    
    getAxisMajorUnit()
  - getAxisMinorUnit
```
public int getAxisMinorUnit(int axisType)
```
    Returns the minor tick unit of the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    Returns:
    
    int - minor tick unit of the desired axis
    
    See Also:
    
    getAxisMinorUnit()
  - setAxisMax
```
public void setAxisMax(int axisType,
                       int MaxValue)
```
    Sets the maximum scale value of the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    Note: The default scale setting for charts is known as Automatic Scaling
    When data changes, the chart automatically adjusts the scale as necessary
    Setting the scale manually (either Minimum or Maximum Value) removes Automatic Scaling
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    int - MaxValue - desired maximum value of the desired axis
    
    See Also:
    
    setAxisMax(int MaxValue)
  - setAxisMin
```
public void setAxisMin(int axisType,
                       int MinValue)
```
    Sets the minimum scale value of the desired Value axis
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    Note: The default setting for charts is known as Automatic Scaling
    When data values change, the chart automatically adjusts the scale as necessary
    Setting the scale manually (either Minimum or Maximum Value) removes Automatic Scaling
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    int - MinValue - the desired Minimum scale value
    
    See Also:
    
    setAxisMin(int MinValue)
  - getAxisAutomaticScale
```
public boolean getAxisAutomaticScale(int axisType)
```
    Returns true if the desired Value axis is set to automatic scale
    The Value axis contains numbers rather than labels, and is normally the Y axis, but Scatter and Bubble charts may have a value axis on the X Axis as well
    Note: The default setting for charts is known as Automatic Scaling
    When data changes, the chart automatically adjusts the scale as necessary
    Setting the scale manually (either Minimum or Maximum Value) removes Automatic Scaling
    
    Parameters:
    
    int - axisType - one of ChartHandle.YAXIS, ChartHandle.XAXIS, ChartHandle.ZAXIS
    
    Returns:
    
    boolean true if Automatic Scaling is turned on
    
    See Also:
    
    getAxisAutomaticScale()
  - getAxisAutomaticScale
```
public boolean getAxisAutomaticScale()
```
    Returns true if the Y Axis (Value axis) is set to automatic scale
    The default setting for charts is known as Automatic Scaling
    When data changes, the chart automatically adjusts the scale (minimum, maximum values plus major and minor tick units) as necessary
    
    Returns:
    
    boolean true if Automatic Scaling is turned on
    
    See Also:
    
    getAxisAutomaticScale(int axisType)
  - setAxisAutomaticScale
```
public void setAxisAutomaticScale(boolean b)
```
    Sets the automatic scale option on or off for the Y Axis (Value axis)
    Automatic Scaling will automatically set the scale maximum, minimum and tick units upon data changes, and is the default chart setting
    
    Parameters:
    
    b -
    
    See Also:
    
    setAxisAutomaticScale(int axisType boolean b)
  - getAxisMinScale
```
public double getAxisMinScale()
```
    Returns the minimum value of the Y Axis (Value Axis) scale
    
    Returns:
    
    int Miminum Scale value for Y axis
    
    See Also:
    
    getAxisMinScale(int axisType)
  - getAxisMaxScale
```
public double getAxisMaxScale()
```
    Returns the maximum value of the Y Axis (Value Axis) scale
    
    Returns:
    
    int Maximum Scale value for Y axis
    
    See Also:
    
    getAxisMaxScale(int axisType)
  - getAxisMajorUnit
```
public int getAxisMajorUnit()
```
    Returns the major tick unit of the Y Axis (Value Axis)
    
    Returns:
    
    int major tick unit
    
    See Also:
    
    getAxisMajorUnit(int axisType)
  - getAxisMinorUnit
```
public int getAxisMinorUnit()
```
    Returns the minor tick unit of the Y Axis (Value Axis)
    
    Returns:
    
    int minor tick unit
    
    See Also:
    
    getAxisMinorUnit(int axisType)
  - setAxisMax
```
public void setAxisMax(int MaxValue)
```
    Sets the maximum value of the Y Axis (Value Axis) Scale
    Note: The default scale setting for charts is known as Automatic Scaling
    When data changes, the chart automatically adjusts the scale as necessary
    Setting the scale manually (either Minimum or Maximum Value) removes Automatic Scaling
    
    Parameters:
    
    int - MaxValue - the desired maximum scale value
    
    See Also:
    
    ChartHandle.setAxisMax(int axisType, int MaxValue)
  - setAxisMin
```
public void setAxisMin(int MinValue)
```
    Sets the minimum value of the Y Axis (Value Axis) Scale
    Note: The default setting for charts is known as Automatic Scaling
    When data changes, the chart automatically adjusts the scale as necessary
    Setting the scale manually (either Minimum or Maximum Value) removes Automatic Scaling
    
    Parameters:
    
    int - MinValue - the desired minimum scale value
    
    See Also:
    
    ChartHandle.setAxisMin(int axisType, int MinValue)
  - setAxisOption
```
public void setAxisOption(int axisType,
                          String op,
                          String val)
```
    sets an option for this axis
    
    Parameters:
    
    axisType - one of: XAXIS, YAXIS, ZAXIS
    
    op - option name; one of: CatCross, LabelCross, Marks, CrossBetween, CrossMax, MajorGridLines, AddArea, AreaFg, AreaBg or Linked Text Display options: Label, ShowKey, ShowValue, ShowLabelPct, ShowPct, ShowCatLabel, ShowBubbleSizes, TextRotation, Font
    
    val - option value
  - setTitleFont
```
public void setTitleFont(String name,
                         int height,
                         boolean bold,
                         boolean italic,
                         boolean underline)
```
    set the font for the chart title
    
    Parameters:
    
    String - name - font name
    
    int - height - font height in 1/20 point units
    
    boolean - bold - true if bold
    
    boolean - italic - true if italic
    
    boolean - underline - true if underlined
  - setTitleFont
```
public void setTitleFont(Font f)
```
    set the font for the Chart Title
    
    Parameters:
    
    io.starter.Formats.XLS.Font - f - desired font for the Chart Title
    
    See Also:
    
    Font
  - getTitleFont
```
public Font getTitleFont()
```
    returns the Font associated with the Chart Title
    
    Returns:
    
    io.starter.Formats.XLS.Font
    
    See Also:
    
    Font
  - setAxisFont
```
public void setAxisFont(String name,
                        int height,
                        boolean bold,
                        boolean italic,
                        boolean underline)
```
    set the font for all axes on the chart
    
    Parameters:
    
    String - name - font name
    
    int - height - font height in 1/20 point units
    
    boolean - bold - true if bold
    
    boolean - italic - true if italic
    
    boolean - underline - true if underlined
  - setAxisFont
```
public void setAxisFont(Font f)
```
    set the font for all axes on the Chart
    
    Parameters:
    
    io.starter.Formats.XLS.Font - f - desired font for the Chart axes
    
    See Also:
    
    Font
  - getAxisFont
```
public Font getAxisFont()
```
    return the Font associated with the Chart Axes
    
    Returns:
    
    io.starter.Formats.XLS.Font for Chart Axes or null if no axes
    
    See Also:
    
    Font
  - resetFonts
```
public void resetFonts()
```
    resets all fonts in the chart to the default font of the workbook
  - getSheet
```
public Boundsheet getSheet()
```
    returns the underlhying Sheet Object this Chart is attached to
    For Internal Use
    
    Returns:
    
    Boundsheet
  - getPlotAreaBgColor
```
public int getPlotAreaBgColor()
```
    return the background color of this chart's Plot Area as an int
    
    Returns:
    
    int background color constant
    
    See Also:
    
    constants
  - getPlotAreaBgColorStr
```
public String getPlotAreaBgColorStr()
```
  - setPlotAreaBgColor
```
public void setPlotAreaBgColor(int bg)
```
    sets the Plot Area background color
    
    Parameters:
    
    int - bg - color constant
    
    See Also:
    
    constants
  - changeTextValue
```
public boolean changeTextValue(String originalval,
                               String newval)
```
    Change the value of a Chart object.
    NOTE: THIS HAS NOT BEEN 100% IMPLEMENTED YET
    You can use this method to change:
    - the Title of the Chart
    - the Text Labels of Categories and Values (X and Y)
    eg:
    To change the value of the Chart title
    chart.changeObjectValue("Template Chart Title", "Widget Sales By Quarter");
    To change the text label of the categories
    chart.changeObjectValue("Category X", "Fiscal Year");
    To change the text label of the values
    chart.changeObjectValue("Value Y", "Sales in US$");
    
    Parameters:
    
    String - originalval - One of: "Template Chart Title", "Category X" or "Value Y"
    
    Sring - newval - the new setting
    
    Returns:
    
    whether the change was successful
  - setChartType
```
public void setChartType(int chartType)
```
    Sets the Chart type to the specified basic type (no 3d, no stacked ...)
    To see possible Chart Types, view the public static int's in ChartHandle.
    Possible Chart Types:
    BARCHART
    COLCHART
    LINECHART
    PIECHART
    AREACHART
    SCATTERCHART
    RADARCHART
    SURFACECHART
    DOUGHNUTCHART
    BUBBLECHART
    RADARAREACHART
    PYRAMIDCHART
    CYLINDERCHART
    CONECHART
    PYRAMIDBARCHART
    CYLINDERBARCHART
    CONEBAR
    
    Parameters:
    
    int - chartType - representing the chart type
  - createNewChart
```
public static ChartHandle createNewChart(WorkSheetHandle sheet,
                                         int chartType,
                                         EnumSet<ChartHandle.ChartOptions> options)
```
    Static method to create a new chart on WorkSheet sheet of type chartType with chart Options options
    After creating, you can set the chart title via ChartHandle.setTitle
    and Position via ChartHandle.setRelativeBounds (row/col-based) or ChartHandle.setCoords (pixel-based)
    as well as several other customizations possible
    
    Parameters:
    
    book - WorkBookHandle
    
    sheet - WorkSheetHandle
    
    chartType - one of:
    BARCHART
    COLCHART
    LINECHART
    PIECHART
    AREACHART
    SCATTERCHART
    RADARCHART
    SURFACECHART
    DOUGHNUTCHART
    BUBBLECHART
    RADARAREACHART
    PYRAMIDCHART
    CYLINDERCHART
    CONECHART
    PYRAMIDBARCHART
    CYLINDERBARCHART
    CONEBARCHART
    
    options - EnumSet
    
    Returns:
    
    See Also:
    
    ChartHandle.ChartOptions, setChartType
  - setChartType
```
public void setChartType(int chartType,
                         int nChart,
                         EnumSet<ChartHandle.ChartOptions> options)
```
    Sets the Chart type to the specified type (no 3d, no stacked ...)
    To see possible Chart Types, view the public static int's in ChartHandle.
    Possible Chart Types:
    BARCHART
    COLCHART
    LINECHART
    PIECHART
    AREACHART
    SCATTERCHART
    RADARCHART
    SURFACECHART
    DOUGHNUTCHART
    BUBBLECHART
    RADARAREACHART
    PYRAMIDCHART
    CYLINDERCHART
    CONECHART
    PYRAMIDBARCHART
    CYLINDERBARCHART
    CONEBARCHART
    
    Parameters:
    
    int - chartType - representing the chart type
    
    nChart - - 0 (default) or 1-9 for complex overlay charts
    
    EnumSet - 0 or more chart options (Such as Stacked, Exploded ...)
    
    See Also:
    
    ChartHandle.ChartOptions
  - setChartType
```
public void setChartType(int chartType,
                         int nChart)
```
    Sets the basic chart type (no 3d, stacked...) for multiple or overlay Charts.
    You can specify the drawing order of the Chart, where 0 is the default chart, and 1-9 are overlay charts.
    The default chart (chart 0) is always present; however, using this method, you can create a new overlay chart (up to 9 maximum).
    NOTE: The chart number must be unique and in order
    If the desired chart number is not present in the chart, a new overlay chart will be created.
    To set explicit chart options, @see setChartType(chartType, nChart, is3d, isStacked, is100PercentStacked)
    
    To see possible Chart Types, view the public static int's in ChartHandle.
    Possible Chart Types:
    BARCHART
    COLCHART
    LINECHART
    PIECHART
    AREACHART
    SCATTERCHART
    RADARCHART
    SURFACECHART
    DOUGHNUTCHART
    BUBBLECHART
    RADARAREACHART
    PYRAMIDCHART
    CYLINDERCHART
    CONECHART
    PYRAMIDBARCHART
    CYLINDERBARCHART
    CONEBARCHART
    
    Parameters:
    
    int - chartType - representing the chart type
    
    chartType -
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - getChartType
```
public int getChartType()
```
    Return an int corresponding to this ChartHandle's Chart Type for the default chart
    To see possible Chart Types, view the public static int's in ChartHandle.
    
    Returns:
    
    int chart type
    
    See Also:
    
    static Chart Type Constants, ChartHandle.setChartType
  - getChartType
```
public int getChartType(int nChart)
```
    Return an int corresponding to this ChartHandle's Chart Type for the specified chart
    To see possible Chart Types, view the public static int's in ChartHandle.
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    int chart type
    
    See Also:
    
    static Chart Type Constants, ChartHandle.setChartType
  - changeSeriesRange
```
public boolean changeSeriesRange(String originalrange,
                                 String newrange)
```
    Change the Cell Range referenced by one of the Series (a bar, line or wedge of data) in the Chart.
    
    For Example, if the data values for one of the Series in the Chart are obtained from the range Sheet1!A1:A10 and we want to add 5 more values to that Series, use:
    boolean changedOK = charthandle.changeSeriesRange("Sheet1!A1:A10","Sheet1!A1:A15");
    
    Please keep in mind this is only the data range; it does not include labels that may have been automatically created when you chose the chart range.
    
    To illustrate this, if A1 = "label" A2 = "data" A3 = "data", and we want to add 2 more data points, we would use: changeSeriesRange("Sheet1!A2:A3", "Sheet1!A2:A5");
    
    Series are always expressed as one single line of data. If your chart encompasses a range of rows and columns you will need to modify each of the series in the chart handle. To determine the series that already exist in your chart, utilize the String[] getSeries() method.
    
    Parameters:
    
    String - originalrange - the original Series (bar, line or wedge of data) to alter
    
    String - newrange -the new data range
    
    Returns:
    
    whether the change was successful
  - changeCategoryRange
```
public boolean changeCategoryRange(String originalrange,
                                   String newrange)
```
    Change the Cell Range representing the Categories in the Chart.
    Categories usually appear on the X Axis and are textual, not numeric
    For example: the Category values in the Chart are obtained from the range Sheet1!A1:A10 and we want to add 5 more categories to the chart:
    boolean changedOK = chart.changeCategoryRange("Sheet1!A1:A10","Sheet1!A1:A15");
    Note that Category Range is the same for each Series (bar, line or wedge of data)
    i.e. there is only one Category Range for the Chart, but there may be many Series Ranges
    
    Parameters:
    
    String - originalrange - Original Category Range
    
    String - newrange - New Category Range
    
    Returns:
    
    true if the change was successful
  - setSeries
```
public ChartSeriesHandle setSeries(int index,
                                   String legendCell,
                                   String categoryRange,
                                   String seriesRange,
                                   String bubbleRange)
                            throws CellNotFoundException
```
    Changes or adds a Series to the chart via Series Index. Each bar, line or wedge in a chart represents a Series.
    If the Series index is greater than the number of series already present in the chart, the series will be added to the end.
    Otherwise the Series at the index position will be altered.
    This method allows altering of every aspect of the Series: Data (Series) Range, Legend Cell Address, Category Range and/or Bubble Range.
    
    Parameters:
    
    int - index - the series index. If greater than the number of series already present in the chart, the series will be added to the end
    
    String - legendCell - String representation of Legend Cell Address
    
    String - categoryRange - String representation of Category Range (should be same for all series)
    
    String - seriesRange - String representation of the Series Data Range for this series
    
    String - bubbleRange - String representation of Bubble Range (representing bubble sizes), if bubble chart. null if not
    
    Returns:
    
    a ChartSeriesHandle representing the new or altered Series
    
    Throws:
    
    CellNotFoundException
  - setSeries
```
public ChartSeriesHandle setSeries(int index,
                                   String legendCell,
                                   String legendText,
                                   String categoryRange,
                                   String seriesRange,
                                   String bubbleRange)
                            throws CellNotFoundException
```
    Changes or adds a Series to the chart via Series Index. Each bar, line or wedge in a chart represents a Series.
    If the Series index is greater than the number of series already present in the chart, the series will be added to the end.
    Otherwise the Series at the index position will be altered.
    This method allows altering of every aspect of the Series: Data (Series) Range, Legend Text, Legend Cell Address, Category Range and/or Bubble Range.
    
    Parameters:
    
    int - index - the series index. If greater than the number of series already present in the chart, the series will be added to the end
    
    String - legendCell - String representation of Legend Cell Address
    
    String - legendText - String Legend text
    
    String - categoryRange - String representation of Category Range (should be same for all series)
    
    String - seriesRange - String representation of the Series Data Range for this series
    
    String - bubbleRange - String representation of Bubble Range (representing bubble sizes), if bubble chart. null if not
    
    Returns:
    
    a ChartSeriesHandle representing the new or altered Series
    
    Throws:
    
    CellNotFoundException
  - setSeries
```
public ChartSeriesHandle setSeries(int index,
                                   String legendCell,
                                   String legendText,
                                   String categoryRange,
                                   String seriesRange,
                                   String bubbleRange,
                                   int nChart)
                            throws CellNotFoundException
```
    Changes or adds a Series to the desired Chart (either default or overlay) via Series Index. Each bar, line or wedge in a chart represents a Series.
    If the Series index is greater than the number of series already present in the chart, the series will be added to the end.
    Otherwise the Series at the index position will be altered.
    This method allows altering of every aspect of the Series: Data (Series) Range, Legend Text, Legend Cell Address, Category Range and/or Bubble Range.
    
    Parameters:
    
    int - index - the series index. If greater than the number of series already present in the chart, the series will be added to the end
    
    String - legendCell - String representation of Legend Cell Address
    
    String - legendText - String Legend text
    
    String - categoryRange - String representation of Category Range (should be same for all series)
    
    String - seriesRange - String representation of the Series Data Range for this series
    
    String - bubbleRange - String representation of Bubble Range (representing bubble sizes), if bubble chart. null if not
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    a ChartSeriesHandle representing the new or altered Series
    
    Throws:
    
    CellNotFoundException
  - addSeriesRange
```
public ChartSeriesHandle addSeriesRange(String legendCell,
                                        String categoryRange,
                                        String seriesRange,
                                        String bubbleRange)
                                 throws CellNotFoundException
```
    Adds a new Series to the chart. Each bar, line or wedge in a chart represents a Series.
    An Example of adding multiple series to a chart:
    ChartHandle.addSeriesRange("Sheet1!A3", "Sheet1!B1:E1", "Sheet1:B3:E3", null);
    ChartHandle.addSeriesRange("Sheet1!A4", "Sheet1!B1:E1", "Sheet1:B4:E4", null);
    ChartHandle.addSeriesRange("Sheet1!A5", "Sheet1!B1:E1", "Sheet1:B5:E5", null);
    etc...
    Note that the category does not change, it is usually constant through series.
    Also note that the example above is for a non-bubble-type chart.
    
    Parameters:
    
    String - legendCell - Cell reference for the legend cell (e.g. Sheet1!A1)
    
    String - categoryRange - Category Cell range (e.g. Sheet1!B1:B1);
    
    String - seriesRange - Series Data range (e.g. Sheet1!B3:E3);
    
    String - bubbleRange - Cell Range representing Bubble sizes (e.g. Sheet1!A2:A5); or null if chart is not of type Bubble.
    
    Returns:
    
    ChartSeriesHandle referencing the newly added series
    
    Throws:
    
    CellNotFoundException
  - addSeriesRange
```
public ChartSeriesHandle addSeriesRange(String legendCell,
                                        String categoryRange,
                                        String seriesRange,
                                        String bubbleRange,
                                        int nChart)
                                 throws CellNotFoundException
```
    Adds a new Series to the chart. Each bar, line or wedge in a chart represents a Series.
    An Example of adding multiple series to a chart:
    ChartHandle.addSeriesRange("Sheet1!A3", "Sheet1!B1:E1", "Sheet1:B3:E3", null);
    ChartHandle.addSeriesRange("Sheet1!A4", "Sheet1!B1:E1", "Sheet1:B4:E4", null);
    ChartHandle.addSeriesRange("Sheet1!A5", "Sheet1!B1:E1", "Sheet1:B5:E5", null);
    etc...
    Note that the category does not change, it is usually constant through series.
    Also note that the example above is for a non-bubble-type chart.
    
    Parameters:
    
    String - legendCell - Cell reference for the legend cell (e.g. Sheet1!A1)
    
    String - categoryRange - Category Cell range (e.g. Sheet1!B1:B1);
    
    String - seriesRange - Series Data range (e.g. Sheet1!B3:E3);
    
    String - bubbleRange - Cell Range representing Bubble sizes (e.g. Sheet1!A2:A5); or null if chart is not of type Bubble.
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    ChartSeriesHandle referencing the newly added series
    
    Throws:
    
    CellNotFoundException
  - addSeriesRange
```
public ChartSeriesHandle addSeriesRange(CellHandle legendCell,
                                        CellRange categoryRange,
                                        CellRange seriesRange,
                                        CellRange bubbleRange)
```
    Adds a new Series to the chart via CellHandles and CellRange Objects. Each bar, line or wedge in a chart represents a Series.
    
    Parameters:
    
    CellHandle - legendCell - references the legend cell for this series
    
    CellRange - categoryRange - The CellRange referencing the category (should be the same for all Series)
    
    CelLRange - seriesRange - The CellRange referencing the data points for one bar, line or wedge in the chart
    
    CellRange - bubbleRange -The CellRange referencing bubble sizes for this series, or null if chart is not of type BUBBLE
    
    Returns:
    
    ChartSeriesHandle referencing the newly added series
    
    See Also:
    
    ChartHandle.addSeriesRange(String legendCell, String categoryRange, String seriesRange, String bubbleRange)
  - addSeriesRange
```
public ChartSeriesHandle addSeriesRange(CellHandle legendCell,
                                        CellRange categoryRange,
                                        CellRange seriesRange,
                                        CellRange bubbleRange,
                                        int nChart)
```
    Adds a new Series to the chart via CellHandles and CellRange Objects. Each bar, line or wedge in a chart represents a Series.
    This method can update the default chart (nChart==0) or overlay charts (nChart 1-9)
    
    Parameters:
    
    CellHandle - legendCell - references the legend cell for this series
    
    CellRange - categoryRange - The CellRange referencing the category (should be the same for all Series)
    
    CelLRange - seriesRange - The CellRange referencing the data points for one bar, line or wedge in the chart
    
    CellRange - bubbleRange -The CellRange referencing bubble sizes for this series, or null if chart is not of type BUBBLE
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    ChartSeriesHandle referencing the newly added series
    
    See Also:
    
    ChartHandle.addSeriesRange(String legendCell, String categoryRange, String seriesRange, String bubbleRange)
  - removeSeries
```
public void removeSeries(int index)
```
    remove the Series (bar, line or wedge) at the desired index
    
    Parameters:
    
    int - index - series index (valid values: 0 to getAllChartSeriesHandles().length-1)
    
    See Also:
    
    getAllChartSeriesHandles
  - removeSeries
```
public void removeSeries(int index,
                         int nChart)
```
    remove the Series (bar, line or wedge) at the desired index
    
    Parameters:
    
    int - index - series index (valid values: 0 to getAllChartSeriesHandles().length-1)
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    See Also:
    
    getAllChartSeriesHandles
  - addAllSeries
```
public void addAllSeries(String[] valueRanges,
                         String[] legendCells,
                         String[] bubbleSizeRanges,
                         String categoryRange)
```
    updates (replaces) every Chart Series (bar, line or wedge on the Chart) with the data from the array of values, legends, bubble sizes (optional) and category range.
    NOTE: all arrays must be the same size (the exception is the bubleSizeRanges array, which may be null)
    NOTE: String arrays come in reverse order from plugins, so this method adds series LIFO i.e. reversed
    
    Parameters:
    
    String[] - valueRanges - Array of Cell Ranges representing the Values or Data points for each series (bar, line or wedge) on the Chart
    
    String[] - legendCells - Array of Cell Addresses representing the legends for each Series
    
    String[] - bubbleSizeRanges - Array of Cell ranges representing the bubble sizes for the Chart, or null if chart is not of type BUBBLE
    
    String - categoryRange - The Cell Range representing the categories (X Axis) for the entire Chart
  - appendRowSeriesToChart
```
public ChartSeriesHandle appendRowSeriesToChart()
```
    Appends a series one row below the last series in the chart.
    This can be utilized when programmatically adding rows of data that should be reflected in the chart.
    Legend cell will be incremented by one row if a reference. Category range will stay the same.
    In order for this method to work properly the chart must have row-based series. If your chart utilizes column-based series, then you need to append a category.
    
    Returns:
    
    ChartSeriesHandle representing newly added series
    
    See Also:
    
    ChartHandle.appendRowCategoryToChart
  - appendRowSeriesToChart
```
public ChartSeriesHandle appendRowSeriesToChart(int nChart)
```
    Appends a series one row below the last series in the chart for the desired chart
    This can be utilized when programmatically adding rows of data that should be reflected in the chart.
    Legend cell will be incremented by one row if a reference. Category range will stay the same.
    In order for this method to work properly the chart must have row-based series. If your chart utilizes column-based series, then you need to append a category.
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    ChartSeriesHandle representing newly added series
    
    See Also:
    
    ChartHandle.appendRowCategoryToChart
  - appendRowCategoryToChart
```
public void appendRowCategoryToChart()
```
    Append a row of categories to the bottom of the chart.
    Expands all Series to include the new bottom row.
    To be utilized when expanding a chart to encompass more data that has a col-based series.
    
    See Also:
    
    ChartHandle.appendRowSeriesToChart
  - appendRowCategoryToChart
```
public void appendRowCategoryToChart(int nChart)
```
    Append a row of categories to the bottom of the chart.
    Expands all Series to include the new bottom row.
    To be utilized when expanding a chart to encompass more data that has a col-based series.
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    See Also:
    
    ChartHandle.appendRowSeriesToChart
  - getChartBytes
```
public byte[] getChartBytes()
```
    Get the Chart's bytes This is an internal method that is not useful to the end user.
  - getSerialBytes
```
public byte[] getSerialBytes()
```
  - parseXML
```
public void parseXML(WorkSheetHandle sht,
                     org.xmlpull.v1.XmlPullParser xpp,
                     HashMap<?,?> maps)
```
    given a XmlPullParser positioned at the chart element, parse all chart elements to create desired chart
    
    Parameters:
    
    sht - WorkSheetHandle
    
    xpp - XmlPullParser
  - getXML
```
public String getXML()
```
    returns an XML representation of this chart
    
    Returns:
    
    String XML
  - getOOXML
```
public String getOOXML(int rId)
```
    Generates OOXML (chartML) for this chart object.
    NOTE: necessary root chartSpace element + namespaces are not set here
    
    Parameters:
    
    int - rId -reference ID for this chart
    
    Returns:
    
    String representing the OOXML describing this Chart
  - getChartDrawingOOXML
```
public String getChartDrawingOOXML(int id)
```
    generates the OOXML specific for DrawingML, specifying offsets and identifying the chart object.
    this Drawing ML (OOXML) is distinct from Chart ML (OOXML) which actually defines the chart object including series, categories and axes
    This is an internal method that is not useful to the end user.
    
    Parameters:
    
    int - id - the reference id for this chart
    
    Returns:
    
    String OOXML
  - parseOOXML
```
public void parseOOXML(InputStream ii)
```
    defines this chart object based on a Chart ML (OOXML) input Stream (root element=c:chartSpace)
    This is an internal method that is not useful to the end user.
    
    Parameters:
    
    inputStream - ii - representing chart OOXML
  - setEditMovement
```
public void setEditMovement(String editMovement)
```
    Specifies how to resize or move this Chart upon edit
    This is an internal method that is not useful to the end user.
    Excel 7/OOXML specific
    
    Parameters:
    
    editMovement - String OOXML-specific edit movement setting
  - setOOXMLName
```
public void setOOXMLName(String name)
```
    set the Excel 7/OOXML-specific name for this chart
    
    Parameters:
    
    String - name
  - getChartEmbeds
```
public ArrayList<?> getChartEmbeds()
```
    returns the drawingml file name which defines the userShape (if any)
    a userShape is a drawing or shape ontop of a chart associated with this chart
    
    Returns:
  - addChartEmbed
```
public void addChartEmbed(String[] ce)
```
    sets external information linked to or "embedded" in this OOXML chart; can be a chart user shape, an image ...
    NOTE: a userShape is a drawingml file name which defines the userShape (if any)
    a userShape is a drawing or shape ontop of a chart
    
    Parameters:
    
    String[] - embedType, filename e.g. {"userShape", "userShape file name"}
  - setDimensionsRecord
```
protected void setDimensionsRecord()
```
    set the chart DIMENSIONS record based on the series ranges in the chart APPEARS THAT for charts, the DIMENSIONS record merely notes the range of values: 0, #points in series, 0, #series
  - setChartOption
```
public void setChartOption(String op,
                           String val)
```
    Method for setting Chart-Type-specific options in a generic fashion e.g. charthandle.setChartOption("Stacked", "true");
    Note: since most Chart Type Options are interdependent, there are several makeXX methods that set the desired group of options e.g. makeStacked(); use setChartOption with care
    Note that not all Chart Types will have every option available
    Possible Options:
    "Stacked" - true or false - set Chart Series to be Stacked
    "Cluster" - true or false - set Clustered for Column and Bar Chart Types
    "PercentageDisplay" - true or false - Each Category is broken down as a percentge
    "Percentage" - Distance of pie slice from center of pie as % for Pie Charts (0 for all others)
    "donutSize" - Donut size for Donut Charts Only
    "Overlap" - Space between bars (default= 0%)
    "Gap" - Space between categories (%) (default=50%)
    "SmoothedLine" - true or false - the Line series has a smoothed line
    "AnRot" - Rotation Angle (0 to 360 degrees), usually 0 for pie, 20 for others (3D option)
    "AnElev" - Elevation Angle (-90 to 90 degrees) (15 is default) (3D option)
    "ThreeDScaling" - true or false - 3d effect
    "TwoDWalls" - true if 2D walls (3D option)
    "PcDist" - Distance from eye to chart (0 to 100) (30 is default) (3D option)
    "ThreeDBubbles" - true or false - Draw bubbles with a 3d effect
    "ShowLdrLines" - true or false - Show Pie and Donut charts Leader Lines
    "MarkerFormat" - "0" thru "9" for various marker options @see ChartHandle.setMarkerFormat
    "ShowLabel" - true or false - show Series/Data Label
    "ShowCatLabel" - true or false - show Category Label
    "ShowLabelPct" - true or false - show percentage labels for Pie charts
    "ShowBubbleSizes" - true or false - show bubble sizes for Bubble charts
    NOTE: all values must be in String form
    
    See Also:
    
    ChartHandle.getXML
  - isThreeD
```
public boolean isThreeD(int nChart)
```
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
    
    Returns:
    
    true if Chart has 3D effects, false otherwise
  - isThreeD
```
public boolean isThreeD()
```
    Returns:
    
    true if Chart has 3D effects, false otherwise
  - isStacked
```
public boolean isStacked()
```
    Returns:
    
    boolean true if Chart contains Stacked Series, false otherwise
  - is100PercentStacked
```
public boolean is100PercentStacked()
```
    Returns:
    
    boolean true if Chart is of type 100% Stacked, false otherwise
  - isClustered
```
public boolean isClustered()
```
    Returns:
    
    boolean true if Chart contains Clustered Bars or Columns, false otherwise
  - getThreeDXML
```
public String getThreeDXML()
```
    Returns:
    
    String ThreeD options in XML form
  - getAxisPlacement
```
public int getAxisPlacement(int Axis)
```
    Returns the Axis Label Placement or position as an int
    One of:
    Axis.INVISIBLE - axis is hidden
    Axis.LOW - low end of plot area
    Axis.HIGH - high end of plot area
    Axis.NEXTTO- next to axis (default)
    
    Parameters:
    
    int - Axis - one of the Axis constants (XAXIS, YAXIS or ZAXIS)
    
    Returns:
    
    int - one of the Axis Label placement constants above
  - setAxisPlacement
```
public void setAxisPlacement(int Axis,
                             int Placement)
```
    Sets the Axis labels position or placement to the desired value (these match Excel placement options)
    Possible options:
    Axis.INVISIBLE - hides the axis
    Axis.LOW - low end of plot area
    Axis.HIGH - high end of plot area
    Axis.NEXTTO- next to axis (default)
    
    Parameters:
    
    int - Axis - one of the Axis constants (XAXIS, YAXIS or ZAXIS)
    
    Placement - - int one of the Axis placement constants listed above
  - removeAxis
```
public void removeAxis(int axisType)
```
    removes the desired Axis from the Chart
    
    Parameters:
    
    int - axisType - one of the Axis constants (XAXIS, YAXIS or ZAXIS)
  - getChartFontRecsXML
```
public String getChartFontRecsXML()
```
    returns Chart-specific Font Records in XML form
    
    Returns:
    
    String Chart Font information in XML format
  - getChartFontsXML
```
public String getChartFontsXML()
```
    Return non-axis Chart font ids in XML form
    
    Returns:
    
    String Font information in XML format
  - setChartFont
```
public void setChartFont(String type,
                         String val)
```
    Set non-axis chart font id for title, default, etc
    For Internal Use Only
    
    Parameters:
    
    String - type - font type
    
    String - val - font id
  - getWorkBook
```
public WorkBook getWorkBook()
```
    Returns:
    
    the WorkBook Object attached to this Chart
  - getWorkBookHandle
```
public WorkBookHandle getWorkBookHandle()
```
  - getWorkSheetHandle
```
public WorkSheetHandle getWorkSheetHandle()
```
  - setBounds
```
public void setBounds(short[] bounds)
```
    sets the coordinates or bounds (position, width and height) of this chart in pixels
    
    Parameters:
    
    short[4] - bounds - left or x value, top or y value, width, height
    
    See Also:
    
    ChartHandle.X, ChartHandle.Y, ChartHandle.WIDTH, ChartHandle.HEIGHT
  - getBounds
```
public short[] getBounds()
```
    returns the coordinates or bounds (position, width and height) of this chart in pixels
    
    Returns:
    
    short[4] bounds - left or x value, top or y value, width, height
    
    See Also:
    
    ChartHandle.X, ChartHandle.Y, ChartHandle.WIDTH, ChartHandle.HEIGHT
  - setCoords
```
public void setCoords(short[] coords)
```
    sets the coordinates (position, width and height) for this chart in Excel size units
    
    See Also:
    
    ChartHandle.X, ChartHandle.Y, ChartHandle.WIDTH, ChartHandle.HEIGHT
  - getCoords
```
public short[] getCoords()
```
    returns the coordinates (position, width and height) of this chart in Excel size units
    
    Returns:
    
    short[4] pixel coords - left or x value, top or y value, width, height
    
    See Also:
    
    ChartHandle.X, ChartHandle.Y, ChartHandle.WIDTH, ChartHandle.HEIGHT
  - getRelativeBounds
```
public short[] getRelativeBounds()
```
    get the bounds of the chart using coordinates relative to row/cols and their offsets
    
    Returns:
    
    short[8] bounds - COL, COLOFFSET, ROW, ROWOFFST, COL1, COLOFFSET1, ROW1, ROWOFFSET1
  - getColOffset
```
public short getColOffset()
```
    returns the offset within the column in pixels
    
    Returns:
  - setRelativeBounds
```
public void setRelativeBounds(short[] bounds)
```
    sets the bounds of the chart using coordinates relative to row/cols and their offsets
    
    Parameters:
    
    short[8] - bounds - COL, COLOFFSET, ROW, ROWOFFST, COL1, COLOFFSET1, ROW1, ROWOFFSET1
  - setDataLabel
```
public void setDataLabel(String type,
                         boolean bShowLegendKey)
```
  - showDataTable
```
public void showDataTable(boolean bShow)
```
    shows or removes the Data Table for this chart
    
    Parameters:
    
    boolean - bShow - true if show data table
  - showLegend
```
public void showLegend(boolean bShow,
                       boolean vertical)
```
    shows or hides the Chart legend key
    
    Parameters:
    
    booean - bShow - true if show legend, false to hide
    
    boolean - vertical - true if show vertically, false for horizontal
  - hasDataLegend
```
public boolean hasDataLegend()
```
    returns true if Chart has a Data Legend Key showing
    
    Returns:
    
    true if Chart has a Data Legend Key showing
  - removeLegend
```
public void removeLegend()
```
  - makeStacked
```
@Deprecated
public void makeStacked(int nChart)
```
    Deprecated.
    
    makes this Chart Stacked
    sets the group of options necessary to create a stacked chart
    For Chart Types:
    BAR, COL, LINE, AREA, PYRAMID, PYRAMIDBAR, CYLINDER, CYLINDERBAR, CONE, CONEBAR
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - make100PercentStacked
```
@Deprecated
public void make100PercentStacked(int nChart)
```
    Deprecated.
    
    makes this Chart 100% Stacked
    sets the group of options necessary to create a 100% stacked chart
    For Chart Types:
    BAR, COL, LINE, PYRAMID, PYRAMIDBAR, CYLINDER, CYLINDERBAR, CONE, CONEBAR
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - makeStacked3D
```
public void makeStacked3D(int nChart)
```
    makes this Chart Stacked with a 3D Effect
    sets the group of options necessary to create a Stacked 3D chart
    For Chart Types:
    BAR, COL, AREA
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - make100PercentStacked3D
```
@Deprecated
public void make100PercentStacked3D(int nChart)
```
    Deprecated.
    
    makes this Chart 100% Stacked with a 3D Effect
    sets the group of options necessary to create a 100% Stacked 3D chart
    For Chart Types:
    BAR, COL, AREA
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - make3D
```
@Deprecated
public void make3D()
```
    Deprecated. use setChartType(chartType, 0, is3d, isStacked, is100PercentStacked) instead
    
    makes the default Chart hava a 3D effect
    sets the group of options necessary to create a 3D chart
    For Chart Types:
    BARCHART, COLCHART, LINECHART, PIECHART, AREACHART, BUBBLECHART, PYRAMIDCHART, CYLINDERCHART, CONECHART
  - make3D
```
@Deprecated
public void make3D(int nChart)
```
    Deprecated. use setChartType(chartType, nChart, is3d, isStacked, is100%Stacked) instead
    
    makes the desired Chart hava a 3D effect
    where nChart 0= default, 1-9=multiple charts in one
    sets the group of options necessary to create a 3D chart
    For Chart Types:
    BARCHART, COLCHART, LINECHART, PIECHART, AREACHART, BUBBLECHART, PYRAMIDCHART, CYLINDERCHART, CONECHART
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - makeClustered3D
```
@Deprecated
public void makeClustered3D(int nChart)
```
    Deprecated.
    
    makes this Chart Clusted with a 3D effect
    sets the group of options necessary to create a Clusted 3D chart
    For Chart Types:
    BAR, COL
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - makeExploded
```
@Deprecated
public void makeExploded()
```
    Deprecated.
    
    makes this chart's wedges exploded i.e. separated
    For Chart Types:
    PIECHART, DOUGHNUTCHART
  - makeExploded3D
```
@Deprecated
public void makeExploded3D(int nChart)
```
    Deprecated.
    
    makes this chart's wedges exploded 3D i.e. separated with a 3D effect
    For Chart Types:
    PIECHART, DOUGHNUTCHART
    
    Parameters:
    
    nChart - number and drawing order of the desired chart (default= 0 max=9 where 1-9 indicate an overlay chart)
  - setMarkerFormat
```
public void setMarkerFormat(int imf)
```
    set the marker format style for this chart
    one of:
    0 = no marker
    1 = square
    2 = diamond
    3 = triangle
    4 = X
    5 = star
    6 = Dow-Jones
    7 = standard deviation
    8 = circle
    9 = plus sign
    For Chart Types:
    LINE, SCATTER
    
    Parameters:
    
    int - imf - marker format constant from list above
  - getJSON
```
public String getJSON()
```
    returs the JSON representation of this chart, based upon Dojo-charting-specifics
    
    Returns:
    
    String JSON representation of the chart
  - inputJSONObject
```
protected void inputJSONObject(org.json.JSONObject source,
                               org.json.JSONObject input)
```
    utility to add a JSON object
    This is an internal method that is not useful to the end user.
    
    Parameters:
    
    source -
    
    input -
  - getSeriesJSON
```
public org.json.JSONArray getSeriesJSON()
```
    retrieves the saved Series JSON for comparisons
    This is an internal method that is not useful to the end user.
    
    Returns:
    
    JSONArray
  - setSeriesJSON
```
public void setSeriesJSON(org.json.JSONArray s)
                   throws org.json.JSONException
```
    sets the saved Series JSON
    This is an internal method that is not useful to the end user.
    
    Parameters:
    
    JSONArray - s -
    
    Throws:
    
    org.json.JSONException
  - getCurrentSeries
```
public org.json.JSONObject getCurrentSeries()
```
    retrieves current series and axis scale info in JSONObject form used upon chart updating
    This is an internal method that is not useful to the end user.
    
    Returns:
    
    JSONObject series and axis info
  - getAllSeriesDataJSON
```
public String getAllSeriesDataJSON()
```
    returns a JSON representation of all Series Data (Legend, Categogies, Series Values) for the chart
    This is an internal method that is not useful to the end user.
    
    Returns:
    
    String JSON representation
  - getSVG
```
public String getSVG()
```
    TODO: Less Common Charts: STOCK RADAR SURFACE COLUMN- 3D, CONE, CYLINDER, PYRAMID BAR- 3D, CONE, CYLINDER, PYRAMID 3D PIE 3D LINE 3D AREA LINE CHART APPEARS THAT STARTS AND ENDS A BIT TOO EARLY ***************** Z Axis CHART OPTIONS: STACKED CLUSTERED
  - getSVG
```
public String getSVG(double scale)
```
    /** Take current Chart object and return the SVG code necessary to define it, scaled to the desired percentage e.g. 0.75= 75%
    
    Parameters:
    
    scale - double scale factor
    
    Returns:
    
    String SVG
  - getJavaScript
```
protected String getJavaScript()
```
    returns the svg for javascript for highlight and restore
    
    Returns:
  - WriteMainChartRecs
```
public void WriteMainChartRecs(String fName)
```
    debugging utility remove when done
  - getAxis
```
public Axis getAxis(int type)
```

Class ChartHandle

Nested Class Summary

Field Summary

Fields inherited from interface io.starter.formats.XLS.charts.ChartConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BARCHART

COLCHART

LINECHART

PIECHART

AREACHART

SCATTERCHART

RADARCHART

SURFACECHART

DOUGHNUTCHART

BUBBLECHART

OFPIECHART

PYRAMIDCHART

CYLINDERCHART

CONECHART

PYRAMIDBARCHART

CYLINDERBARCHART

CONEBARCHART

RADARAREACHART

STOCKCHART

BAR

COL

LINE

PIE

AREA

SCATTER

RADAR

SURFACE

DOUGHNUT

BUBBLE

RADARAREA

PYRAMID

CYLINDER

CONE

PYRAMIDBAR

CYLINDERBAR

CONEBAR

XAXIS

YAXIS

ZAXIS

XVALAXIS

X

Y

WIDTH

HEIGHT

wbh

Constructor Detail

ChartHandle

Method Detail

getTitle

setTitle

getDataRangeJSON

getEncompassingDataRange

getEncompassingDataRange

getId

toString

getSeries

getCategories

getAllChartSeriesHandles

getAllChartSeriesHandles

getChartSeriesHandle

getChartSeriesHandle

getChartSeriesHandleByName

setAxisTitle

getYAxisLabel

setYAxisLabel

getXAxisLabel

setXAxisLabel

getZAxisLabel

setZAxisLabel

setAxisAutomaticScale

getAxisMinScale

getAxisMaxScale