Package org.apache.poi.xssf.usermodel

Class XSSFChart

java.lang.Object

org.apache.poi.ooxml.POIXMLDocumentPart

org.apache.poi.xddf.usermodel.chart.XDDFChart

org.apache.poi.xssf.usermodel.XSSFChart

All Implemented Interfaces:

TextContainer

public final class XSSFChart
extends XDDFChart

Represents a SpreadsheetML Chart

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

POIXMLDocumentPart.RelationPart

Field Summary

Fields inherited from class org.apache.poi.xddf.usermodel.chart.XDDFChart

axes, chartSpace, DEFAULT_HEIGHT, DEFAULT_WIDTH, DEFAULT_X, DEFAULT_Y

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	XSSFChart()	Create a new SpreadsheetML chart
protected	XSSFChart(PackagePart part)	Construct a SpreadsheetML chart from a package part.

Method Summary

Modifier and Type	Method	Description
protected void	commit()	save chart xml
protected POIXMLFactory	getChartFactory()
protected POIXMLRelation	getChartRelation()
protected POIXMLRelation	getChartWorkbookRelation()
XSSFGraphicFrame	getGraphicFrame()	Returns the parent graphic frame.
String	getTitleFormula()	Get the chart title formula expression if there is one
XSSFRichTextString	getTitleText()	Returns the title static text, or null if none is set.
protected void	setGraphicFrame(XSSFGraphicFrame frame)	Sets the parent graphic frame.
void	setTitleFormula(String formula)	Set the formula expression to use for the chart title

Methods inherited from class org.apache.poi.xddf.usermodel.chart.XDDFChart

clear, clearChartSeries, createCategoryAxis, createData, createDateAxis, createRelationshipInChart, createSeriesAxis, createValueAxis, deleteLegend, deleteShapeProperties, displayBlanksAs, fillSheet, findDefinedParagraphProperty, findDefinedRunProperty, formatRange, getAxes, getChartIndex, getChartSeries, getCTChart, getCTChartSpace, getCTPlotArea, getFormattedTitle, getOrAddLegend, getOrAddManualLayout, getOrAddShapeProperties, getOrAddView3D, getTitle, getTitleOverlay, getWorkbook, importContent, incrementSeriesCount, isPlotOnlyVisibleCells, plot, removeTitle, replaceReferences, saveWorkbook, setAutoTitleDeleted, setBackWall, setChartIndex, setExternalId, setFloor, setPlotOnlyVisibleCells, setSheetTitle, setSideWall, setTitleOverlay, setTitleText, setValueRange, setWorkbook

Methods inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

_invokeOnDocumentRead, addRelation, createHyperlink, createRelationship, createRelationship, createRelationship, getNextPartNumber, getPackagePart, getParent, getReferenceRelationship, getReferenceRelationships, getRelationById, getRelationId, getRelationPartById, getRelationParts, getRelations, getTargetPart, isCommitted, onDocumentCreate, onDocumentRead, onDocumentRemove, onSave, prepareForCommit, read, rebase, removeReferenceRelationship, removeRelation, removeRelation, removeRelation, setCommitted, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

XSSFChart

protected XSSFChart()

Create a new SpreadsheetML chart

XSSFChart

protected XSSFChart(PackagePart part)
             throws IOException,
org.apache.xmlbeans.XmlException

Construct a SpreadsheetML chart from a package part.

Parameters:

part - the package part holding the chart data, the content type must be application/vnd.openxmlformats-officedocument.drawingml.chart+xml

Throws:

IOException

org.apache.xmlbeans.XmlException

Since:

3.14-Beta1

Method Details

getChartRelation

protected POIXMLRelation getChartRelation()

Specified by:

getChartRelation in class XDDFChart

Returns:

the chart relation in the implementing subclass.

getChartWorkbookRelation

protected POIXMLRelation getChartWorkbookRelation()

Specified by:

getChartWorkbookRelation in class XDDFChart

Returns:

the chart workbook relation in the implementing subclass.

getChartFactory

protected POIXMLFactory getChartFactory()

Specified by:

getChartFactory in class XDDFChart

Returns:

the chart factory in the implementing subclass.

commit

protected void commit()
               throws IOException

Description copied from class: XDDFChart

save chart xml

Overrides:

commit in class XDDFChart

Throws:

IOException - a subclass may throw an IOException if the changes can't be committed

getGraphicFrame

public XSSFGraphicFrame getGraphicFrame()

Returns the parent graphic frame.

Returns:

the graphic frame this chart belongs to

setGraphicFrame

protected void setGraphicFrame(XSSFGraphicFrame frame)

Sets the parent graphic frame.

getTitleText

public XSSFRichTextString getTitleText()

Returns the title static text, or null if none is set. Note that a title formula may be set instead. Empty text result is for backward compatibility, and could mean the title text is empty or there is a formula instead. Check for a formula first, falling back on text for cleaner logic.

Returns:

static title text if set, null if there is no title, empty string if the title text is empty or the title uses a formula instead

getTitleFormula

public String getTitleFormula()

Get the chart title formula expression if there is one

Returns:

formula expression or null

setTitleFormula

public void setTitleFormula(String formula)

Set the formula expression to use for the chart title