Chart (Aspose.Cells for Java)

java.lang.Object
- com.aspose.cells.Chart

public class Chart
extends java.lang.Object

Encapsulates the object that represents a single Excel chart.

Example

The following codes show how to create a chart with .Net codes.

 
         Workbook workbook = new Workbook();
                Worksheet sheet = workbook.getWorksheets().get(0);
 
                Cells cells = sheet.getCells();
                cells.get(0,1).putValue("Income");
                cells.get(1,0).putValue("Company A");
                cells.get(2,0).putValue("Company B");
                cells.get(3,0).putValue("Company C");
                cells.get(1,1).putValue(10000);
                cells.get(2,1).putValue(20000);
                cells.get(3,1).putValue(30000);
 
                int chartIndex = sheet.getCharts().add(ChartType.COLUMN, 9, 9, 21, 15);
 
                Chart chart = sheet.getCharts().get(chartIndex);
         chart.setChartDataRange("A1:B4", true);
                chart.setShowLegend(true);
                chart.getTitle().setText("Income Analysis");

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`calculate()` Calculates the custom position of plot area, axes if the position of them are auto assigned.
`void`	`calculate(ChartCalculateOptions calculateOptions)` Calculates the custom position of plot area, axes if the position of them are auto assigned, with Chart Calculate Options.
`void`	`changeTemplate(byte[] data)` Change chart type with preset template.
`int[]`	`getActualChartSize()` Deprecated. Use Chart.getActualSize() method instead.
`int[]`	`getActualSize()` Gets actual size of chart in unit of pixels.
`boolean`	`getAutoScaling()` True if Microsoft Excel scales a 3-D chart so that it's closer in size to the equivalent 2-D chart.
`Walls`	`getBackWall()` Returns a `getWalls()` object that represents the back wall of a 3-D chart.
`Axis`	`getCategoryAxis()` Gets the chart's X axis.
`ChartArea`	`getChartArea()` Gets the chart area in the worksheet.
`java.lang.String`	`getChartDataRange()` Gets the data source range of the chart.
`ChartDataTable`	`getChartDataTable()` Represents the chart data table.
`ChartShape`	`getChartObject()` Represents the chartShape;
`ChartShape`	`getChartShape()` Deprecated. Use Aspose.Cells.Charts.Chart.ChartObject property instead.
`int`	`getDepthPercent()` Represents the depth of a 3-D chart as a percentage of the chart width (between 20 and 2000 percent).
`boolean`	`getDisplayNaAsBlank()` Indicates whether displaying #N/A as blank value.
`int`	`getElevation()` Represents the elevation of the 3-D chart view, in degrees.
`SeriesCollection`	`getFilteredNSeries()` Gets a `SeriesCollection` collection representing the data series that are filtered in the chart.
`int`	`getFirstSliceAngle()` Gets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical).
`Floor`	`getFloor()` Returns a `getFloor()` object that represents the walls of a 3-D chart.
`int`	`getGapDepth()` Gets the distance between the data series in a 3-D chart, as a percentage of the marker width.
`int`	`getGapWidth()` Returns or sets the space between bar or column clusters, as a percentage of the bar or column width.
`int`	`getHeightPercent()` Returns or sets the height of a 3-D chart as a percentage of the chart width (between 5 and 500 percent).
`boolean`	`getHidePivotFieldButtons()` Indicates whether hide the pivot chart field buttons only when the chart is PivotChart.
`boolean`	`getIs3D()` Indicates whether the chart is a 3d chart.
`Legend`	`getLegend()` Gets the chart legend.
`Line`	`getLine()` Gets the line.
`java.lang.String`	`getName()` Gets the name of the chart.
`SeriesCollection`	`getNSeries()` Gets a `SeriesCollection` collection representing the data series in the chart.
`PageSetup`	`getPageSetup()` Represents the page setup description in this chart.
`short`	`getPerspective()` Returns or sets the perspective for the 3-D chart view.
`PivotOptions`	`getPivotOptions()` Specifies the pivot controls that appear on the chart
`java.lang.String`	`getPivotSource()` The source is the data of the pivotTable.
`int`	`getPlacement()` Represents the way the chart is attached to the cells below it.
`PlotArea`	`getPlotArea()` Gets the chart's plot area which includes axis tick labels.
`int`	`getPlotBy()` Gets whether plot by row or column.
`int`	`getPlotEmptyCellsType()` Gets how to plot the empty cells.
`boolean`	`getPlotVisibleCells()` Deprecated. Use PlotVisibleCellsOnly property instead.
`boolean`	`getPlotVisibleCellsOnly()` Indicates whether plot visible cells only.
`int`	`getPrintSize()` Gets the printed chart size.
`boolean`	`getRightAngleAxes()` True if the chart axes are at right angles.
`int`	`getRotationAngle()` Represents the rotation of the 3-D chart view (the rotation of the plot area around the z-axis, in degrees).
`Axis`	`getSecondCategoryAxis()` Gets the chart's second X axis.
`Axis`	`getSecondValueAxis()` Gets the chart's second Y axis.
`Axis`	`getSeriesAxis()` Gets the chart's series axis.
`ShapeCollection`	`getShapes()` Returns all drawing shapes in this chart.
`boolean`	`getShowDataTable()` Gets a value indicating whether the chart displays a data table.
`boolean`	`getShowLegend()` Gets a value indicating whether the chart legend will be displayed.
`Walls`	`getSideWall()` Returns a `getWalls()` object that represents the side wall of a 3-D chart.
`boolean`	`getSizeWithWindow()` True if Microsoft Excel resizes the chart to match the size of the chart sheet window.
`int`	`getStyle()` Gets the builtin style.
`Title`	`getSubTitle()` Gets the chart's sub-title.
`Title`	`getTitle()` Gets the chart's title.
`int`	`getType()` Gets a chart's type.
`Axis`	`getValueAxis()` Gets the chart's Y axis.
`Walls`	`getWalls()` Returns a `getWalls()` object that represents the walls of a 3-D chart.
`boolean`	`getWallsAndGridlines2D()` True if gridlines are drawn two-dimensionally on a 3-D chart.
`Worksheet`	`getWorksheet()` Gets the worksheet which contains this chart.
`boolean`	`hasAxis(int aixsType, boolean isPrimary)` Returns which axes exist on the chart.
`boolean`	`isCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)` Returns whether the cell refered by the chart.
`boolean`	`isChartDataChanged()` Detects if a chart's data source has changed.
`boolean`	`isRectangularCornered()` Gets a value indicating whether the chart area is rectangular cornered.
`boolean`	`isReferedByChart(int rowIndex, int columnIndex)` Deprecated. Use Chart.IsCellReferedByChart(int,int,int) method instead.
`void`	`move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)` Moves the chart to a specified location.
`void`	`refreshPivotData()` Refreshes chart's data from pivot table.
`void`	`setAutoScaling(boolean value)` True if Microsoft Excel scales a 3-D chart so that it's closer in size to the equivalent 2-D chart.
`void`	`setChartDataRange(java.lang.String area, boolean isVertical)` Specifies data range for a chart.
`void`	`setDepthPercent(int value)` Represents the depth of a 3-D chart as a percentage of the chart width (between 20 and 2000 percent).
`void`	`setDisplayNaAsBlank(boolean value)` Indicates whether displaying #N/A as blank value.
`void`	`setElevation(int value)` Represents the elevation of the 3-D chart view, in degrees.
`void`	`setFirstSliceAngle(int value)` Sets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical).
`void`	`setGapDepth(int value)` Sets the distance between the data series in a 3-D chart, as a percentage of the marker width.
`void`	`setGapWidth(int value)` Returns or sets the space between bar or column clusters, as a percentage of the bar or column width.
`void`	`setHeightPercent(int value)` Returns or sets the height of a 3-D chart as a percentage of the chart width (between 5 and 500 percent).
`void`	`setHidePivotFieldButtons(boolean value)` Indicates whether hide the pivot chart field buttons only when the chart is PivotChart.
`void`	`setName(java.lang.String value)` Sets the name of the chart.
`void`	`setPerspective(short value)` Returns or sets the perspective for the 3-D chart view.
`void`	`setPivotSource(java.lang.String value)` The source is the data of the pivotTable.
`void`	`setPlacement(int value)` Represents the way the chart is attached to the cells below it.
`void`	`setPlotEmptyCellsType(int value)` Sets how to plot the empty cells.
`void`	`setPlotVisibleCells(boolean value)` Deprecated. Use PlotVisibleCellsOnly property instead.
`void`	`setPlotVisibleCellsOnly(boolean value)` Indicates whether plot visible cells only.
`void`	`setPrintSize(int value)` Sets the printed chart size.
`void`	`setRectangularCornered(boolean value)` Sets a value indicating whether the chart area is rectangular cornered.
`void`	`setRightAngleAxes(boolean value)` True if the chart axes are at right angles.
`void`	`setRotationAngle(int value)` Represents the rotation of the 3-D chart view (the rotation of the plot area around the z-axis, in degrees).
`void`	`setShowDataTable(boolean value)` Sets a value indicating whether the chart displays a data table.
`void`	`setShowLegend(boolean value)` Sets a value indicating whether the chart legend will be displayed.
`void`	`setSizeWithWindow(boolean value)` True if Microsoft Excel resizes the chart to match the size of the chart sheet window.
`void`	`setStyle(int value)` Sets the builtin style.
`void`	`setType(int value)` Sets a chart's type.
`void`	`setWallsAndGridlines2D(boolean value)` True if gridlines are drawn two-dimensionally on a 3-D chart.
`boolean`	`switchRowColumn()` Switches row/column.
`void`	`toImage(java.io.OutputStream stream, ImageOrPrintOptions options)` Creates the chart image and saves it to a stream in the specified format.
`void`	`toImage(java.lang.String imageFile)` Creates the chart image and saves it to a file.
`void`	`toImage(java.lang.String imageFile, ImageFormat imageFormat)` Deprecated. Use Chart.ToImage(string, ImageType) method instead.
`void`	`toImage(java.lang.String imageFile, ImageOrPrintOptions options)` Creates the chart image and saves it to a file.
`void`	`toImage(java.lang.String imageFile, int imageType)` Creates the chart image and saves it to a file in the specified image type.
`void`	`toImage(java.lang.String imageFile, long jpegQuality)` Deprecated. Use Chart.ToImage(string,ImageOrPrintOptions) method instead.
`void`	`toPdf(java.io.OutputStream stream)` Creates the chart pdf and saves it to a stream.
`void`	`toPdf(java.io.OutputStream stream, float desiredPageWidth, float desiredPageHeight, int hAlignmentType, int vAlignmentType)` Creates the chart pdf and saves it to a stream.
`void`	`toPdf(java.lang.String fileName)` Saves the chart to a pdf file.
`void`	`toPdf(java.lang.String fileName, float desiredPageWidth, float desiredPageHeight, int hAlignmentType, int vAlignmentType)` Saves the chart to a pdf file.

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

- Method Detail
  - getStyle
```
public int getStyle()
```
    Gets the builtin style.
    Remarks
    It should be between 1 and 48. Return -1 if it's not be set.
  - setStyle
```
public void setStyle(int value)
```
    Sets the builtin style.
    Remarks
    It should be between 1 and 48. Return -1 if it's not be set.
  - getChartObject
```
public ChartShape getChartObject()
```
    Represents the chartShape;
  - getHidePivotFieldButtons
```
public boolean getHidePivotFieldButtons()
```
    Indicates whether hide the pivot chart field buttons only when the chart is PivotChart.
  - setHidePivotFieldButtons
```
public void setHidePivotFieldButtons(boolean value)
```
    Indicates whether hide the pivot chart field buttons only when the chart is PivotChart.
  - getPivotOptions
```
public PivotOptions getPivotOptions()
```
    Specifies the pivot controls that appear on the chart
  - getPivotSource
```
public java.lang.String getPivotSource()
```
    The source is the data of the pivotTable. If PivotSource is not empty ,the chart is PivotChart.
    Remarks
    If the pivot table "PivotTable1" in the Worksheet "Sheet1" in the file "Book1.xls". The pivotSource could be "[Book1.xls]Sheet1!PivotTable1" if the chart and the PivotTable is not in the same workbook. If you set this property ,the previous data source setting will be lost.
  - setPivotSource
```
public void setPivotSource(java.lang.String value)
```
    The source is the data of the pivotTable. If PivotSource is not empty ,the chart is PivotChart.
    Remarks
    If the pivot table "PivotTable1" in the Worksheet "Sheet1" in the file "Book1.xls". The pivotSource could be "[Book1.xls]Sheet1!PivotTable1" if the chart and the PivotTable is not in the same workbook. If you set this property ,the previous data source setting will be lost.
  - isReferedByChart
```
public boolean isReferedByChart(int rowIndex,
                       int columnIndex)
```
    Deprecated. Use Chart.IsCellReferedByChart(int,int,int) method instead.
    
    Returns whether the cell refered by the chart.
    Remarks
    NOTE: This method is now obsolete. Instead, please use IsCellReferedByChart(int,int,int) method. This method will be removed 12 months later since April 2023. Aspose apologizes for any inconvenience you may have experienced.
    
    Parameters:
    rowIndex - The row index
    columnIndex - The column index
    
    Returns:
  - isCellReferedByChart
```
public boolean isCellReferedByChart(int sheetIndex,
                           int rowIndex,
                           int columnIndex)
```
    Returns whether the cell refered by the chart.
    
    Parameters:
    sheetIndex - The sheet Index.-1 means the worksheet which contains current chart.
    rowIndex - The row index
    columnIndex - The column index
    
    Returns:
  - isChartDataChanged
```
public boolean isChartDataChanged()
```
    Detects if a chart's data source has changed.
    Remarks
    The method detects the changes in the chart's data source before rendering the chart to image format. At first Chart.toImage call, the chart source data (e.g. XValuesParseData, ValuesParseData) will be recorded. Before calling the Chart.toImage method again, call IsChartDataChanged method to check if Chart needs re-rendering.
    
    Returns:
    Returns true if the chart has changed otherwise returns false
  - getPlotBy
```
public int getPlotBy()
```
    Gets whether plot by row or column.
    See PlotDataByType.
  - refreshPivotData
```
public void refreshPivotData()
```
    Refreshes chart's data from pivot table.
    Remarks
    We will gather data from pivot data source to the pivot table report. This method is only used to gather all data to a pivot chart.
  - getPlotEmptyCellsType
```
public int getPlotEmptyCellsType()
```
    Gets how to plot the empty cells.
    See PlotEmptyCellsType.
  - setPlotEmptyCellsType
```
public void setPlotEmptyCellsType(int value)
```
    Sets how to plot the empty cells.
    See PlotEmptyCellsType.
  - getPlotVisibleCells
```
public boolean getPlotVisibleCells()
```
    Deprecated. Use PlotVisibleCellsOnly property instead.
    
    Indicates whether only plot visible cells.
    Remarks
    NOTE: This member is now obsolete. Instead, please use PlotVisibleCellsOnly property. This method will be removed 12 months later since December 2022. Aspose apologizes for any inconvenience you may have experienced.
  - setPlotVisibleCells
```
public void setPlotVisibleCells(boolean value)
```
    Deprecated. Use PlotVisibleCellsOnly property instead.
    
    Indicates whether only plot visible cells.
    Remarks
    NOTE: This member is now obsolete. Instead, please use PlotVisibleCellsOnly property. This method will be removed 12 months later since December 2022. Aspose apologizes for any inconvenience you may have experienced.
  - getPlotVisibleCellsOnly
```
public boolean getPlotVisibleCellsOnly()
```
    Indicates whether plot visible cells only.
  - setPlotVisibleCellsOnly
```
public void setPlotVisibleCellsOnly(boolean value)
```
    Indicates whether plot visible cells only.
  - getDisplayNaAsBlank
```
public boolean getDisplayNaAsBlank()
```
    Indicates whether displaying #N/A as blank value.
  - setDisplayNaAsBlank
```
public void setDisplayNaAsBlank(boolean value)
```
    Indicates whether displaying #N/A as blank value.
  - getName
```
public java.lang.String getName()
```
    Gets the name of the chart.
  - setName
```
public void setName(java.lang.String value)
```
    Sets the name of the chart.
  - getSizeWithWindow
```
public boolean getSizeWithWindow()
```
    True if Microsoft Excel resizes the chart to match the size of the chart sheet window.
  - setSizeWithWindow
```
public void setSizeWithWindow(boolean value)
```
    True if Microsoft Excel resizes the chart to match the size of the chart sheet window.
  - getWorksheet
```
public Worksheet getWorksheet()
```
    Gets the worksheet which contains this chart.
  - getShapes
```
public ShapeCollection getShapes()
```
    Returns all drawing shapes in this chart.
  - getPrintSize
```
public int getPrintSize()
```
    Gets the printed chart size.
    See PrintSizeType.
  - setPrintSize
```
public void setPrintSize(int value)
```
    Sets the printed chart size.
    See PrintSizeType.
  - changeTemplate
```
public void changeTemplate(byte[] data)
```
    Change chart type with preset template.
    
    Parameters:
    data - The data of chart template file(.crtx).
  - getType
```
public int getType()
```
    Gets a chart's type.
    See ChartType.
  - setType
```
public void setType(int value)
```
    Sets a chart's type.
    See ChartType.
  - move
```
public void move(int upperLeftRow,
        int upperLeftColumn,
        int lowerRightRow,
        int lowerRightColumn)
```
    Moves the chart to a specified location.
    
    Parameters:
    upperLeftColumn - Upper left column index.
    upperLeftRow - Upper left row index.
    lowerRightColumn - Lower right column index
    lowerRightRow - Lower right row index
  - getNSeries
```
public SeriesCollection getNSeries()
```
    Gets a SeriesCollection collection representing the data series in the chart.
  - getFilteredNSeries
```
public SeriesCollection getFilteredNSeries()
```
    Gets a SeriesCollection collection representing the data series that are filtered in the chart.
  - getTitle
```
public Title getTitle()
```
    Gets the chart's title.
  - getSubTitle
```
public Title getSubTitle()
```
    Gets the chart's sub-title. Only for ODS format file.
  - getPlotArea
```
public PlotArea getPlotArea()
```
    Gets the chart's plot area which includes axis tick labels.
    Remarks
  - getChartArea
```
public ChartArea getChartArea()
```
    Gets the chart area in the worksheet.
  - getCategoryAxis
```
public Axis getCategoryAxis()
```
    Gets the chart's X axis.
  - getValueAxis
```
public Axis getValueAxis()
```
    Gets the chart's Y axis.
  - getSecondValueAxis
```
public Axis getSecondValueAxis()
```
    Gets the chart's second Y axis.
  - getSecondCategoryAxis
```
public Axis getSecondCategoryAxis()
```
    Gets the chart's second X axis.
  - getSeriesAxis
```
public Axis getSeriesAxis()
```
    Gets the chart's series axis.
  - getLegend
```
public Legend getLegend()
```
    Gets the chart legend.
  - getChartDataTable
```
public ChartDataTable getChartDataTable()
```
    Represents the chart data table.
  - getShowLegend
```
public boolean getShowLegend()
```
    Gets a value indicating whether the chart legend will be displayed. Default is true.
  - setShowLegend
```
public void setShowLegend(boolean value)
```
    Sets a value indicating whether the chart legend will be displayed. Default is true.
  - isRectangularCornered
```
public boolean isRectangularCornered()
```
    Gets a value indicating whether the chart area is rectangular cornered. Default is true.
  - setRectangularCornered
```
public void setRectangularCornered(boolean value)
```
    Sets a value indicating whether the chart area is rectangular cornered. Default is true.
  - getShowDataTable
```
public boolean getShowDataTable()
```
    Gets a value indicating whether the chart displays a data table.
  - setShowDataTable
```
public void setShowDataTable(boolean value)
```
    Sets a value indicating whether the chart displays a data table.
  - getFirstSliceAngle
```
public int getFirstSliceAngle()
```
    Gets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Applies only to pie, 3-D pie, and doughnut charts, 0 to 360.
  - setFirstSliceAngle
```
public void setFirstSliceAngle(int value)
```
    Sets the angle of the first pie-chart or doughnut-chart slice, in degrees (clockwise from vertical). Applies only to pie, 3-D pie, and doughnut charts, 0 to 360.
  - getGapWidth
```
public int getGapWidth()
```
    Returns or sets the space between bar or column clusters, as a percentage of the bar or column width. The value of this property must be between 0 and 500.
  - setGapWidth
```
public void setGapWidth(int value)
```
    Returns or sets the space between bar or column clusters, as a percentage of the bar or column width. The value of this property must be between 0 and 500.
  - getGapDepth
```
public int getGapDepth()
```
    Gets the distance between the data series in a 3-D chart, as a percentage of the marker width. The value of this property must be between 0 and 500.
  - setGapDepth
```
public void setGapDepth(int value)
```
    Sets the distance between the data series in a 3-D chart, as a percentage of the marker width. The value of this property must be between 0 and 500.
  - calculate
```
public void calculate()
```
    Calculates the custom position of plot area, axes if the position of them are auto assigned.
  - calculate
```
public void calculate(ChartCalculateOptions calculateOptions)
```
    Calculates the custom position of plot area, axes if the position of them are auto assigned, with Chart Calculate Options.
  - getFloor
```
public Floor getFloor()
```
    Returns a getFloor() object that represents the walls of a 3-D chart.
    Remarks
    This property doesn't apply to 3-D pie charts.
  - getWalls
```
public Walls getWalls()
```
    Returns a getWalls() object that represents the walls of a 3-D chart.
    Remarks
    This property doesn't apply to 3-D pie charts.
  - getBackWall
```
public Walls getBackWall()
```
    Returns a getWalls() object that represents the back wall of a 3-D chart.
  - getSideWall
```
public Walls getSideWall()
```
    Returns a getWalls() object that represents the side wall of a 3-D chart.
  - getWallsAndGridlines2D
```
public boolean getWallsAndGridlines2D()
```
    True if gridlines are drawn two-dimensionally on a 3-D chart.
  - setWallsAndGridlines2D
```
public void setWallsAndGridlines2D(boolean value)
```
    True if gridlines are drawn two-dimensionally on a 3-D chart.
  - getRotationAngle
```
public int getRotationAngle()
```
    Represents the rotation of the 3-D chart view (the rotation of the plot area around the z-axis, in degrees).
    Remarks
    The value of this property must be from 0 to 360, except for 3-D bar charts, where the value must be from 0 to 44. The default value is 20. Applies only to 3-D charts.
  - setRotationAngle
```
public void setRotationAngle(int value)
```
    Represents the rotation of the 3-D chart view (the rotation of the plot area around the z-axis, in degrees).
    Remarks
    The value of this property must be from 0 to 360, except for 3-D bar charts, where the value must be from 0 to 44. The default value is 20. Applies only to 3-D charts.
  - getElevation
```
public int getElevation()
```
    Represents the elevation of the 3-D chart view, in degrees.
    Remarks
    The chart elevation is the height at which you view the chart, in degrees. The default is 15 for most chart types. The value of this property must be between -90 and 90, except for 3-D bar charts, where it must be between 0 and 44.
  - setElevation
```
public void setElevation(int value)
```
    Represents the elevation of the 3-D chart view, in degrees.
    Remarks
    The chart elevation is the height at which you view the chart, in degrees. The default is 15 for most chart types. The value of this property must be between -90 and 90, except for 3-D bar charts, where it must be between 0 and 44.
  - getRightAngleAxes
```
public boolean getRightAngleAxes()
```
    True if the chart axes are at right angles. Applies only for 3-D charts(except Column3D and 3-D Pie Charts).
    Remarks
    If this property is True, the Perspective property is ignored.
  - setRightAngleAxes
```
public void setRightAngleAxes(boolean value)
```
    True if the chart axes are at right angles. Applies only for 3-D charts(except Column3D and 3-D Pie Charts).
    Remarks
    If this property is True, the Perspective property is ignored.
  - getAutoScaling
```
public boolean getAutoScaling()
```
    True if Microsoft Excel scales a 3-D chart so that it's closer in size to the equivalent 2-D chart. The RightAngleAxes property must be True.
  - setAutoScaling
```
public void setAutoScaling(boolean value)
```
    True if Microsoft Excel scales a 3-D chart so that it's closer in size to the equivalent 2-D chart. The RightAngleAxes property must be True.
  - getHeightPercent
```
public int getHeightPercent()
```
    Returns or sets the height of a 3-D chart as a percentage of the chart width (between 5 and 500 percent).
  - setHeightPercent
```
public void setHeightPercent(int value)
```
    Returns or sets the height of a 3-D chart as a percentage of the chart width (between 5 and 500 percent).
  - getPerspective
```
public short getPerspective()
```
    Returns or sets the perspective for the 3-D chart view. Must be between 0 and 100. This property is ignored if the RightAngleAxes property is True.
  - setPerspective
```
public void setPerspective(short value)
```
    Returns or sets the perspective for the 3-D chart view. Must be between 0 and 100. This property is ignored if the RightAngleAxes property is True.
  - getIs3D
```
public boolean getIs3D()
```
    Indicates whether the chart is a 3d chart.
  - getDepthPercent
```
public int getDepthPercent()
```
    Represents the depth of a 3-D chart as a percentage of the chart width (between 20 and 2000 percent).
  - setDepthPercent
```
public void setDepthPercent(int value)
```
    Represents the depth of a 3-D chart as a percentage of the chart width (between 20 and 2000 percent).
  - toImage
```
public void toImage(java.lang.String imageFile)
```
    Creates the chart image and saves it to a file. The extension of the file name determines the format of the image.
    Remarks
    
    The format of the image is specified by using the extension of the file name. For example, if you specify "myfile.png", then the image will be saved in the PNG format. The following file extensions are recognized: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
    If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing.
    
    Parameters:
    imageFile - The image file name with full path.
  - toImage
```
public void toImage(java.lang.String imageFile,
           ImageFormat imageFormat)
```
    Deprecated. Use Chart.ToImage(string, ImageType) method instead.
    
    Creates the chart image and saves it to a file in the specified format.
    Remarks
    NOTE: This member is now obsolete. Instead, please use Chart.ToImage(string, ImageType) method. This property will be removed 12 months later since July 2022. Aspose apologizes for any inconvenience you may have experienced.
    
    Parameters:
    imageFile - The image file name with full path.
    imageFormat - The format in which to save the image.
  - toImage
```
public void toImage(java.lang.String imageFile,
           int imageType)
```
    Creates the chart image and saves it to a file in the specified image type.
    Remarks
    
    The type of the image is specified by using imageType. The following types are supported: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
    If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing.
    
    Parameters:
    imageFile - The image file name with full path.
    imageType - ImageType. The image type in which to save the image.
  - toImage
```
public void toImage(java.lang.String imageFile,
           long jpegQuality)
```
    Deprecated. Use Chart.ToImage(string,ImageOrPrintOptions) method instead.
    
    Creates the chart image and saves it to a file in the Jpeg format.
    Remarks
    If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing. NOTE: This method is now obsolete. Instead, please use ToImage(string,ImageOrPrintOptions) method with specified quality. This method will be removed 12 months later since March 2025. Aspose apologizes for any inconvenience you may have experienced.
    
    Parameters:
    imageFile - The image file name with full path.
    jpegQuality - Jpeg quality.
  - toPdf
```
public void toPdf(java.lang.String fileName)
```
    Saves the chart to a pdf file.
    
    Parameters:
    fileName - the pdf file name with full path
  - toPdf
```
public void toPdf(java.lang.String fileName,
         float desiredPageWidth,
         float desiredPageHeight,
         int hAlignmentType,
         int vAlignmentType)
```
    Saves the chart to a pdf file.
    
    Parameters:
    fileName - the pdf file name with full path
    desiredPageWidth - The desired page width in inches.
    desiredPageHeight - The desired page height in inches.
    hAlignmentType - PageLayoutAlignmentType. The chart horizontal alignment type in the output page.
    vAlignmentType - PageLayoutAlignmentType. The chart vertical alignment type in the output page.
  - toPdf
```
public void toPdf(java.io.OutputStream stream)
```
    Creates the chart pdf and saves it to a stream.
    
    Parameters:
    stream - The output stream.
  - toPdf
```
public void toPdf(java.io.OutputStream stream,
         float desiredPageWidth,
         float desiredPageHeight,
         int hAlignmentType,
         int vAlignmentType)
```
    Creates the chart pdf and saves it to a stream.
    
    Parameters:
    stream - The output stream.
    desiredPageWidth - The desired page width in inches.
    desiredPageHeight - The desired page height in inches.
    hAlignmentType - PageLayoutAlignmentType. The chart horizontal alignment type in the output page.
    vAlignmentType - PageLayoutAlignmentType. The chart vertical alignment type in the output page.
  - toImage
```
public void toImage(java.lang.String imageFile,
           ImageOrPrintOptions options)
```
    Creates the chart image and saves it to a file. The extension of the file name determines the format of the image.
    Remarks
    
    The format of the image is specified by using the extension of the file name. For example, if you specify "myfile.png", then the image will be saved in the PNG format. The following file extensions are recognized: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
    If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing. Please refer to Supported Charts List for more details.
    Example
    Saves to Tiff with 300 dpi and CCITT4 compression.
```
 
         ImageOrPrintOptions options = new ImageOrPrintOptions();
         options.setHorizontalResolution(300);
         options.setVerticalResolution(300);
         options.setTiffCompression(TiffCompression.COMPRESSION_CCITT_4);
 
         Workbook book = new Workbook("test.xls");
         book.getWorksheets().get(0).getCharts().get(0).toImage("chart.Tiff", options);
 
```
    Parameters:
    imageFile - The image file name with full path.
    options - Additional image creation options
  - toImage
```
public void toImage(java.io.OutputStream stream,
           ImageOrPrintOptions options)
```
    Creates the chart image and saves it to a stream in the specified format.
    Remarks
    
    The format of the image is specified by using options.ImageFormat. The following formats are supported: ImageFormat.Bmp, ImageFormat.Gif, ImageFormat.Png, ImageFormat.Jpeg, ImageFormat.Tiff, ImageFormat.Emf.
    If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing. Please refer to Supported Charts List for more details.
    
    Parameters:
    stream - The output stream.
    options - Additional image creation options
  - getActualChartSize
```
public int[] getActualChartSize()
```
    Deprecated. Use Chart.getActualSize() method instead.
    
    Gets actual size of chart in unit of pixels.
    Remarks
    NOTE: This member is now obsolete. Instead, please use Chart.getActualSize() method. This property will be removed 12 months later since July 2022. Aspose apologizes for any inconvenience you may have experienced.
    
    Returns:
    Actual size in an array(width and height). [0] is width; [1] is height.
  - getActualSize
```
public int[] getActualSize()
```
    Gets actual size of chart in unit of pixels.
    
    Returns:
    Actual size in an array(width and height). [0] is width; [1] is height.
  - getPlacement
```
public int getPlacement()
```
    Represents the way the chart is attached to the cells below it.
    See PlacementType.
  - setPlacement
```
public void setPlacement(int value)
```
    Represents the way the chart is attached to the cells below it.
    See PlacementType.
  - getPageSetup
```
public PageSetup getPageSetup()
```
    Represents the page setup description in this chart.
  - getChartShape
```
public ChartShape getChartShape()
```
    Deprecated. Use Aspose.Cells.Charts.Chart.ChartObject property instead.
    
    Represents the chartShape;
    Remarks
    NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Charts.Chart.ChartObject property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.
  - hasAxis
```
public boolean hasAxis(int aixsType,
              boolean isPrimary)
```
    Returns which axes exist on the chart.
    Remarks
    Normally, Pie, PieExploded, PiePie,PieBar, Pie3D, Pie3DExploded,Doughnut, DoughnutExploded is no axis.
  - switchRowColumn
```
public boolean switchRowColumn()
```
    Switches row/column.
    
    Returns:
    False means switching row/column fails.
  - getChartDataRange
```
public java.lang.String getChartDataRange()
```
    Gets the data source range of the chart.
    Remarks
    Only supports range.
    
    Returns:
    The data source.
  - setChartDataRange
```
public void setChartDataRange(java.lang.String area,
                     boolean isVertical)
```
    Specifies data range for a chart.
    
    Parameters:
    area - Specifies values from which to plot the data series
    isVertical - Specifies whether to plot the series from a range of cell values by row or by column.
  - getLine
```
public Line getLine()
```
    Gets the line.

Class Chart

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getStyle

setStyle

getChartObject

getHidePivotFieldButtons

setHidePivotFieldButtons

getPivotOptions

getPivotSource

setPivotSource

isReferedByChart

isCellReferedByChart

isChartDataChanged

getPlotBy

refreshPivotData

getPlotEmptyCellsType

setPlotEmptyCellsType

getPlotVisibleCells

setPlotVisibleCells

getPlotVisibleCellsOnly

setPlotVisibleCellsOnly

getDisplayNaAsBlank

setDisplayNaAsBlank

getName

setName

getSizeWithWindow

setSizeWithWindow

getWorksheet

getShapes

getPrintSize

setPrintSize

changeTemplate

getType

setType

move

getNSeries

getFilteredNSeries

getTitle

getSubTitle

getPlotArea

getChartArea

getCategoryAxis

getValueAxis

getSecondValueAxis

getSecondCategoryAxis

getSeriesAxis

getLegend

getChartDataTable

getShowLegend

setShowLegend

isRectangularCornered

setRectangularCornered

getShowDataTable

setShowDataTable

getFirstSliceAngle

setFirstSliceAngle

getGapWidth

setGapWidth

getGapDepth

setGapDepth

calculate

calculate

getFloor

getWalls

getBackWall

getSideWall

getWallsAndGridlines2D

setWallsAndGridlines2D

getRotationAngle

setRotationAngle

getElevation

setElevation

getRightAngleAxes

setRightAngleAxes

getAutoScaling

setAutoScaling

getHeightPercent

setHeightPercent