com.aspose.words
Class ChartNumberFormat

java.lang.Object
    com.aspose.words.ChartNumberFormat

public class ChartNumberFormat 
extends java.lang.Object

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

chart.getSeries().add("Aspose Test Series",
        new String[]{"Word", "PDF", "Excel", "GoogleDocs", "Note"},
        new double[]{1900000.0, 850000.0, 2100000.0, 600000.0, 1500000.0});

// Set number format.
chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

// Set this to override the above value and draw the number format from the source cell
Assert.assertFalse(chart.getAxisY().getNumberFormat().isLinkedToSource());

public java.lang.String getFormatCode() / public void setFormatCode(java.lang.String value)

Gets or sets the format code applied to a data label.

Number formatting is used to change the way a value appears in data label and can be used in some very creative ways. The examples of number formats:

Number - "#,##0.00"

Currency - "\"$\"#,##0.00"

Time - "[$-x-systime]h:mm:ss AM/PM"

Date - "d/mm/yyyy"

Percentage - "0.00%"

Fraction - "# ?/?"

Scientific - "0.00E+00"

Text - "@"

Accounting - "_-\"$\"* #,##0.00_-;-\"$\"* #,##0.00_-;_-\"$\"* \"-\"??_-;_-@_-"

Custom with color - "[Red]-#,##0.0"

Example:

Shows how to set formatting for chart values.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

chart.getSeries().add("Aspose Test Series",
        new String[]{"Word", "PDF", "Excel", "GoogleDocs", "Note"},
        new double[]{1900000.0, 850000.0, 2100000.0, 600000.0, 1500000.0});

// Set number format.
chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

// Set this to override the above value and draw the number format from the source cell
Assert.assertFalse(chart.getAxisY().getNumberFormat().isLinkedToSource());

Example:

Shows how to set number format for the data labels of the entire series.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Add chart with default data
Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0);
// Delete default generated series
shape.getChart().getSeries().clear();

ChartSeries series =
        shape.getChart().getSeries().add("Aspose Test Series", new String[]{"Word", "PDF", "Excel"}, new double[]{2.5, 1.5, 3.5});

ChartDataLabelCollection dataLabels = series.getDataLabels();
// Display chart values in the data labels, by default it is false
dataLabels.setShowValue(true);
// Set currency format for the data labels of the entire series
dataLabels.getNumberFormat().setFormatCode("\"$\"#,##0.00");

doc.save(getArtifactsDir() + "Charts.DefineNumberFormatForDataLabels.docx");

public boolean isLinkedToSource() / public void isLinkedToSource(boolean value)

Specifies whether the format code is linked to a source cell. Default is true.

The NumberFormat will be reset to general if format code is linked to source.

Example:

Shows how to set formatting for chart values.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert chart.
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Clear demo data.
chart.getSeries().clear();

chart.getSeries().add("Aspose Test Series",
        new String[]{"Word", "PDF", "Excel", "GoogleDocs", "Note"},
        new double[]{1900000.0, 850000.0, 2100000.0, 600000.0, 1500000.0});

// Set number format.
chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

// Set this to override the above value and draw the number format from the source cell
Assert.assertFalse(chart.getAxisY().getNumberFormat().isLinkedToSource());