asposecells.api

Classes

Constants

Class Axis

Encapsulates the object that represents an axis of chart.

Example:

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.getWorksheets().add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.getWorksheets().get(sheetIndex)
# Adding a sample value to "A1" cell
worksheet.getCells().get("A1").putValue(50)
# Adding a sample value to "A2" cell
worksheet.getCells().get("A2").putValue(100)
# Adding a sample value to "A3" cell
worksheet.getCells().get("A3").putValue(150)
# Adding a sample value to "B1" cell
worksheet.getCells().get("B1").putValue(4)
# Adding a sample value to "B2" cell
worksheet.getCells().get("B2").putValue(20)
# Adding a sample value to "B3" cell
worksheet.getCells().get("B3").putValue(50)
# Adding a chart to the worksheet
chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 5, 0, 25, 5)
# Accessing the instance of the newly added chart
chart = worksheet.getCharts().get(chartIndex)
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
chart.getNSeries().add("A1:B3", True)
# Set the max value of value axis
chart.getValueAxis().setMaxValue(200)
# Set the min value of value axis
chart.getValueAxis().setMinValue(0)
# Set the major unit
chart.getValueAxis().setMajorUnit(25)
# Category(X) axis crosses at the maxinum value.
chart.getValueAxis().setCrossType(CrossType.MAXIMUM)
# Set he number of categories or series between tick-mark labels. 
chart.getCategoryAxis().setTickLabelSpacing(2)
# Saving the Excel file
workbook.save("Book1.xlsx")

Property Getters/Setters Summary
`method`	`getArea()`
	Gets the Area.
`method`	`getAxisBetweenCategories()`
`method`	`setAxisBetweenCategories(value)`
	Represents if the value axis crosses the category axis between categories.
`method`	`getAxisLabels()`
	Gets the labels of the axis after call Chart.Calculate() method.
`method`	`getAxisLine()`
	Gets the appearance of an Axis.
`method`	`getBaseUnitScale()`
`method`	`setBaseUnitScale(value)`
	Represents the base unit scale for the category axis. The value of the property is TimeUnit integer constant.
`method`	`getBins()`
	Represents bins on a chart(Histogram/Pareto) axis
`method`	`getCategoryType()`
`method`	`setCategoryType(value)`
	Represents the category axis type. The value of the property is CategoryType integer constant.
`method`	`getCrossAt()`
`method`	`setCrossAt(value)`
	Represents the point on the value axis where the category axis crosses it.
`method`	`getCrossType()`
`method`	`setCrossType(value)`
	Represents the CrossType on the specified axis where the other axis crosses. The value of the property is CrossType integer constant.
`method`	`getCustomUnit()`
`method`	`setCustomUnit(value)`
	Specifies a custom value for the display unit.
`method`	`getCustUnit()`
`method`	`setCustUnit(value)`
	Specifies a custom value for the display unit.
`method`	`getDisplayUnit()`
`method`	`setDisplayUnit(value)`
	Represents the unit label for the specified axis. The value of the property is DisplayUnitType integer constant.
`method`	`getDisplayUnitLabel()`
	Represents a unit label on an axis in the specified chart. Unit labels are useful for charting large values— for example, in the millions or billions.
`method`	`hasMultiLevelLabels()`
`method`	`setHasMultiLevelLabels(value)`
	Indicates whether the labels shall be shown as multi level.
`method`	`isAutomaticMajorUnit()`
`method`	`setAutomaticMajorUnit(value)`
	Indicates whether the major unit of the axis is automatically assigned.
`method`	`isAutomaticMaxValue()`
`method`	`setAutomaticMaxValue(value)`
	Indicates whether the max value is automatically assigned.
`method`	`isAutomaticMinorUnit()`
`method`	`setAutomaticMinorUnit(value)`
	Indicates whether the minor unit of the axis is automatically assigned.
`method`	`isAutomaticMinValue()`
`method`	`setAutomaticMinValue(value)`
	Indicates whether the min value is automatically assigned.
`method`	`isAutoTickLabelSpacing()`
`method`	`setAutoTickLabelSpacing(value)`
	Indicates whether the spacing of tick label is automatic
`method`	`isBaseUnitAuto()`
`method`	`setBaseUnitAuto(value)`
	Represents whether the base unit is automatic.
`method`	`isDisplayUnitLabelShown()`
`method`	`setDisplayUnitLabelShown(value)`
	Represents if the display unit label is shown on the specified axis.
`method`	`isLogarithmic()`
`method`	`setLogarithmic(value)`
	Represents if the value axis scale type is logarithmic or not.
`method`	`isPlotOrderReversed()`
`method`	`setPlotOrderReversed(value)`
	Represents if Microsoft Excel plots data points from last to first.
`method`	`isVisible()`
`method`	`setVisible(value)`
	Represents if the axis is visible.
`method`	`getLogBase()`
`method`	`setLogBase(value)`
	Represents the logarithmic base. Default value is 10.Only applies for Excel2007.
`method`	`getMajorGridLines()`
	Represents major gridlines on a chart axis.
`method`	`getMajorTickMark()`
`method`	`setMajorTickMark(value)`
	Represents the type of major tick mark for the specified axis. The value of the property is TickMarkType integer constant.
`method`	`getMajorUnit()`
`method`	`setMajorUnit(value)`
	Represents the major units for the axis.
`method`	`getMajorUnitScale()`
`method`	`setMajorUnitScale(value)`
	Represents the major unit scale for the category axis. The value of the property is TimeUnit integer constant.
`method`	`getMaxValue()`
`method`	`setMaxValue(value)`
	Represents the maximum value on the value axis.
`method`	`getMinorGridLines()`
	Represents minor gridlines on a chart axis.
`method`	`getMinorTickMark()`
`method`	`setMinorTickMark(value)`
	Represents the type of minor tick mark for the specified axis. The value of the property is TickMarkType integer constant.
`method`	`getMinorUnit()`
`method`	`setMinorUnit(value)`
	Represents the minor units for the axis.
`method`	`getMinorUnitScale()`
`method`	`setMinorUnitScale(value)`
	Represents the major unit scale for the category axis. The value of the property is TimeUnit integer constant.
`method`	`getMinValue()`
`method`	`setMinValue(value)`
	Represents the minimum value on the value axis.
`method`	`getTickLabelPosition()`
`method`	`setTickLabelPosition(value)`
	Represents the position of tick-mark labels on the specified axis. The value of the property is TickLabelPositionType integer constant.
`method`	`getTickLabels()`
	Returns a TickLabels object that represents the tick-mark labels for the specified axis.
`method`	`getTickLabelSpacing()`
`method`	`setTickLabelSpacing(value)`
	Represents the number of categories or series between tick-mark labels. Applies only to category and series axes.
`method`	`getTickMarkSpacing()`
`method`	`setTickMarkSpacing(value)`
	Returns or sets the number of categories or series between tick marks. Applies only to category and series axes.
`method`	`getTitle()`
	Gets the axis' title.

Method Summary
`method`	`getAxisTexts()`
`method`	Gets the labels of the axis after call Chart.Calculate() method.

- Property Getters/Setters Detail
  - getArea : Area
```
Area getArea()
```
    Gets the Area.
  - isAutomaticMinValue/setAutomaticMinValue : boolean
```
boolean isAutomaticMinValue() / setAutomaticMinValue(value)
```
    Indicates whether the min value is automatically assigned.
  - getMinValue/setMinValue : Object
```
Object getMinValue() / setMinValue(value)
```
    Represents the minimum value on the value axis.
    The minValue type only can be double or DateTime
  - isAutomaticMaxValue/setAutomaticMaxValue : boolean
```
boolean isAutomaticMaxValue() / setAutomaticMaxValue(value)
```
    Indicates whether the max value is automatically assigned.
  - getMaxValue/setMaxValue : Object
```
Object getMaxValue() / setMaxValue(value)
```
    Represents the maximum value on the value axis.
    The maxValue type only can be double or DateTime
  - isAutomaticMajorUnit/setAutomaticMajorUnit : boolean
```
boolean isAutomaticMajorUnit() / setAutomaticMajorUnit(value)
```
    Indicates whether the major unit of the axis is automatically assigned.
  - getMajorUnit/setMajorUnit : float
```
float getMajorUnit() / setMajorUnit(value)
```
    Represents the major units for the axis.
    The major units must be greater than zero.
  - isAutomaticMinorUnit/setAutomaticMinorUnit : boolean
```
boolean isAutomaticMinorUnit() / setAutomaticMinorUnit(value)
```
    Indicates whether the minor unit of the axis is automatically assigned.
  - getMinorUnit/setMinorUnit : float
```
float getMinorUnit() / setMinorUnit(value)
```
    Represents the minor units for the axis.
    The minor units must be greater than zero.
  - getAxisLine : Line
```
Line getAxisLine()
```
    Gets the appearance of an Axis.
  - getMajorTickMark/setMajorTickMark : int
```
int getMajorTickMark() / setMajorTickMark(value)
```
    Represents the type of major tick mark for the specified axis. The value of the property is TickMarkType integer constant.
  - getMinorTickMark/setMinorTickMark : int
```
int getMinorTickMark() / setMinorTickMark(value)
```
    Represents the type of minor tick mark for the specified axis. The value of the property is TickMarkType integer constant.
  - getTickLabelPosition/setTickLabelPosition : int
```
int getTickLabelPosition() / setTickLabelPosition(value)
```
    Represents the position of tick-mark labels on the specified axis. The value of the property is TickLabelPositionType integer constant.
  - getCrossAt/setCrossAt : float
```
float getCrossAt() / setCrossAt(value)
```
    Represents the point on the value axis where the category axis crosses it.
    The number should be a integer when it applies to category axis. And the value must be between 1 and 31999.
  - getCrossType/setCrossType : int
```
int getCrossType() / setCrossType(value)
```
    Represents the CrossType on the specified axis where the other axis crosses. The value of the property is CrossType integer constant.
  - getLogBase/setLogBase : float
```
float getLogBase() / setLogBase(value)
```
    Represents the logarithmic base. Default value is 10.Only applies for Excel2007.
  - isLogarithmic/setLogarithmic : boolean
```
boolean isLogarithmic() / setLogarithmic(value)
```
    Represents if the value axis scale type is logarithmic or not.
  - isPlotOrderReversed/setPlotOrderReversed : boolean
```
boolean isPlotOrderReversed() / setPlotOrderReversed(value)
```
    Represents if Microsoft Excel plots data points from last to first.
  - getAxisBetweenCategories/setAxisBetweenCategories : boolean
```
boolean getAxisBetweenCategories() / setAxisBetweenCategories(value)
```
    Represents if the value axis crosses the category axis between categories.
    This property applies only to category axes, and it doesn't apply to 3-D charts.
  - getTickLabels : TickLabels
```
TickLabels getTickLabels()
```
    Returns a TickLabels object that represents the tick-mark labels for the specified axis.
  - getTickLabelSpacing/setTickLabelSpacing : int
```
int getTickLabelSpacing() / setTickLabelSpacing(value)
```
    Represents the number of categories or series between tick-mark labels. Applies only to category and series axes.
    The number must be between 1 and 31999.
  - isAutoTickLabelSpacing/setAutoTickLabelSpacing : boolean
```
boolean isAutoTickLabelSpacing() / setAutoTickLabelSpacing(value)
```
    Indicates whether the spacing of tick label is automatic
  - getTickMarkSpacing/setTickMarkSpacing : int
```
int getTickMarkSpacing() / setTickMarkSpacing(value)
```
    Returns or sets the number of categories or series between tick marks. Applies only to category and series axes.
    The number must be between 1 and 31999.
  - getDisplayUnit/setDisplayUnit : int
```
int getDisplayUnit() / setDisplayUnit(value)
```
    Represents the unit label for the specified axis. The value of the property is DisplayUnitType integer constant.
  - getCustUnit/setCustUnit : int
```
int getCustUnit() / setCustUnit(value)
```
    Specifies a custom value for the display unit.
    NOTE: This property is now obsolete. Instead, please use Axis.CustomUnit property. This property will be removed 12 months later since January 2023. Aspose apologizes for any inconvenience you may have experienced.
  - getCustomUnit/setCustomUnit : int
```
int getCustomUnit() / setCustomUnit(value)
```
    Specifies a custom value for the display unit.
  - getDisplayUnitLabel : DisplayUnitLabel
```
DisplayUnitLabel getDisplayUnitLabel()
```
    Represents a unit label on an axis in the specified chart. Unit labels are useful for charting large values— for example, in the millions or billions.
  - isDisplayUnitLabelShown/setDisplayUnitLabelShown : boolean
```
boolean isDisplayUnitLabelShown() / setDisplayUnitLabelShown(value)
```
    Represents if the display unit label is shown on the specified axis.
    The default value is True.
  - getTitle : Title
```
Title getTitle()
```
    Gets the axis' title.
  - getCategoryType/setCategoryType : int
```
int getCategoryType() / setCategoryType(value)
```
    Represents the category axis type. The value of the property is CategoryType integer constant.
  - getBaseUnitScale/setBaseUnitScale : int
```
int getBaseUnitScale() / setBaseUnitScale(value)
```
    Represents the base unit scale for the category axis. The value of the property is TimeUnit integer constant.
    Setting this property only takes effect when the CategoryType property is set to TimeScale.
  - isBaseUnitAuto/setBaseUnitAuto : boolean
```
boolean isBaseUnitAuto() / setBaseUnitAuto(value)
```
    Represents whether the base unit is automatic.
  - getMajorUnitScale/setMajorUnitScale : int
```
int getMajorUnitScale() / setMajorUnitScale(value)
```
    Represents the major unit scale for the category axis. The value of the property is TimeUnit integer constant.
    Example:
    workbook = Workbook() # Adding a new worksheet to the Excel object sheetIndex = workbook.getWorksheets().add() # Obtaining the reference of the newly added worksheet by passing its sheet index worksheet = workbook.getWorksheets().get(sheetIndex) # Adding a sample value to "A1" cell worksheet.getCells().get("A1").putValue(50) # Adding a sample value to "A2" cell worksheet.getCells().get("A2").putValue(100) # Adding a sample value to "A3" cell worksheet.getCells().get("A3").putValue(150) # Adding a sample value to "B1" cell worksheet.getCells().get("B1").putValue(4) # Adding a sample value to "B2" cell worksheet.getCells().get("B2").putValue(20) # Adding a sample value to "B3" cell worksheet.getCells().get("B3").putValue(50) # Adding a chart to the worksheet chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 5, 0, 25, 5) # Accessing the instance of the newly added chart chart = worksheet.getCharts().get(chartIndex) chart.getCategoryAxis().setCategoryType(CategoryType.TIME_SCALE) chart.getCategoryAxis().setMajorUnitScale(TimeUnit.MONTHS) chart.getCategoryAxis().setMajorUnit(2)
  - getMinorUnitScale/setMinorUnitScale : int
```
int getMinorUnitScale() / setMinorUnitScale(value)
```
    Represents the major unit scale for the category axis. The value of the property is TimeUnit integer constant.
    Example:
    workbook = Workbook() # Adding a new worksheet to the Excel object sheetIndex = workbook.getWorksheets().add() # Obtaining the reference of the newly added worksheet by passing its sheet index worksheet = workbook.getWorksheets().get(sheetIndex) # Adding a sample value to "A1" cell worksheet.getCells().get("A1").putValue(50) # Adding a sample value to "A2" cell worksheet.getCells().get("A2").putValue(100) # Adding a sample value to "A3" cell worksheet.getCells().get("A3").putValue(150) # Adding a sample value to "B1" cell worksheet.getCells().get("B1").putValue(4) # Adding a sample value to "B2" cell worksheet.getCells().get("B2").putValue(20) # Adding a sample value to "B3" cell worksheet.getCells().get("B3").putValue(50) # Adding a chart to the worksheet chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 5, 0, 25, 5) # Accessing the instance of the newly added chart chart = worksheet.getCharts().get(chartIndex) chart.getCategoryAxis().setCategoryType(CategoryType.TIME_SCALE) chart.getCategoryAxis().setMinorUnitScale(TimeUnit.MONTHS) chart.getCategoryAxis().setMinorUnit(2)
  - isVisible/setVisible : boolean
```
boolean isVisible() / setVisible(value)
```
    Represents if the axis is visible.
  - getMajorGridLines : Line
```
Line getMajorGridLines()
```
    Represents major gridlines on a chart axis.
    Example:
    workbook = Workbook() # Adding a new worksheet to the Excel object sheetIndex = workbook.getWorksheets().add() # Obtaining the reference of the newly added worksheet by passing its sheet index worksheet = workbook.getWorksheets().get(sheetIndex) # Adding a sample value to "A1" cell worksheet.getCells().get("A1").putValue(50) # Adding a sample value to "A2" cell worksheet.getCells().get("A2").putValue(100) # Adding a sample value to "A3" cell worksheet.getCells().get("A3").putValue(150) # Adding a sample value to "B1" cell worksheet.getCells().get("B1").putValue(4) # Adding a sample value to "B2" cell worksheet.getCells().get("B2").putValue(20) # Adding a sample value to "B3" cell worksheet.getCells().get("B3").putValue(50) # Adding a chart to the worksheet chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 5, 0, 25, 5) # Accessing the instance of the newly added chart chart = worksheet.getCharts().get(chartIndex) chart.getValueAxis().getMajorGridLines().setVisible(False) chart.getCategoryAxis().getMajorGridLines().setVisible(True)
  - getMinorGridLines : Line
```
Line getMinorGridLines()
```
    Represents minor gridlines on a chart axis.
  - hasMultiLevelLabels/setHasMultiLevelLabels : boolean
```
boolean hasMultiLevelLabels() / setHasMultiLevelLabels(value)
```
    Indicates whether the labels shall be shown as multi level.
    Only valid for category axis.
  - getAxisLabels : ArrayList
```
ArrayList getAxisLabels()
```
    Gets the labels of the axis after call Chart.Calculate() method.
    NOTE: This member is now obsolete. Instead, please use Axis.GetAxisTexts method. This property will be removed 12 months later since November 2023. Aspose apologizes for any inconvenience you may have experienced.
  - getBins : AxisBins
```
AxisBins getBins()
```
    Represents bins on a chart(Histogram/Pareto) axis
- Method Detail
  - getAxisTexts
```
String[] getAxisTexts()
```
    Gets the labels of the axis after call Chart.Calculate() method.

asposecells.api

Classes

Constants

Class Axis

Property Getters/Setters Detail

getArea : Area

isAutomaticMinValue/setAutomaticMinValue : boolean

getMinValue/setMinValue : Object

isAutomaticMaxValue/setAutomaticMaxValue : boolean

getMaxValue/setMaxValue : Object

isAutomaticMajorUnit/setAutomaticMajorUnit : boolean

getMajorUnit/setMajorUnit : float

isAutomaticMinorUnit/setAutomaticMinorUnit : boolean

getMinorUnit/setMinorUnit : float

getAxisLine : Line

getMajorTickMark/setMajorTickMark : int

getMinorTickMark/setMinorTickMark : int

getTickLabelPosition/setTickLabelPosition : int

getCrossAt/setCrossAt : float

getCrossType/setCrossType : int

getLogBase/setLogBase : float

isLogarithmic/setLogarithmic : boolean

isPlotOrderReversed/setPlotOrderReversed : boolean

getAxisBetweenCategories/setAxisBetweenCategories : boolean

getTickLabels : TickLabels

getTickLabelSpacing/setTickLabelSpacing : int

isAutoTickLabelSpacing/setAutoTickLabelSpacing : boolean

getTickMarkSpacing/setTickMarkSpacing : int

getDisplayUnit/setDisplayUnit : int

getCustUnit/setCustUnit : int

getCustomUnit/setCustomUnit : int

getDisplayUnitLabel : DisplayUnitLabel

isDisplayUnitLabelShown/setDisplayUnitLabelShown : boolean

getTitle : Title

getCategoryType/setCategoryType : int

getBaseUnitScale/setBaseUnitScale : int

isBaseUnitAuto/setBaseUnitAuto : boolean

getMajorUnitScale/setMajorUnitScale : int

getMinorUnitScale/setMinorUnitScale : int

isVisible/setVisible : boolean

getMajorGridLines : Line

getMinorGridLines : Line

hasMultiLevelLabels/setHasMultiLevelLabels : boolean

getAxisLabels : ArrayList

getBins : AxisBins

Method Detail

getAxisTexts