public class ChartYValueCollection
extends java.lang.Object
implements java.lang.Iterable
Remarks:
All items of the collection other than null must have the same ChartYValue.getValueType().
The collection allows only changing Y values. To add or insert new values to a chart series, or remove values, the appropriate methods of the ChartSeries class can be used.
Examples:
Shows how to get chart series data.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder();
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();
ChartSeries series = chart.getSeries().get(0);
double minValue = Double.MAX_VALUE;
int minValueIndex = 0;
double maxValue = -Double.MAX_VALUE;
int maxValueIndex = 0;
for (int i = 0; i < series.getYValues().getCount(); i++)
{
// Clear individual format of all data points.
// Data points and data values are one-to-one in column charts.
series.getDataPoints().get(i).clearFormat();
// Get Y value.
double yValue = series.getYValues().get(i).getDoubleValue();
if (yValue < minValue)
{
minValue = yValue;
minValueIndex = i;
}
if (yValue > maxValue)
{
maxValue = yValue;
maxValueIndex = i;
}
}
// Change colors of the max and min values.
series.getDataPoints().get(minValueIndex).getFormat().getFill().setForeColor(Color.RED);
series.getDataPoints().get(maxValueIndex).getFormat().getFill().setForeColor(Color.GREEN);
doc.save(getArtifactsDir() + "Charts.GetChartSeriesData.docx");
ChartSeries.add(com.aspose.words.ChartXValue),
ChartSeries.add(com.aspose.words.ChartXValue, com.aspose.words.ChartYValue),
ChartSeries.add(com.aspose.words.ChartXValue, com.aspose.words.ChartYValue, double),
ChartSeries.insert(int, com.aspose.words.ChartXValue),
ChartSeries.insert(int, com.aspose.words.ChartXValue, com.aspose.words.ChartYValue),
ChartSeries.insert(int, com.aspose.words.ChartXValue, com.aspose.words.ChartYValue, double),
ChartSeries.remove(int)| Modifier and Type | Method and Description |
|---|---|
ChartYValue |
get(int index)
Gets the Y value at the specified index.
|
int |
getCount()
Gets the number of items in this collection.
|
java.lang.String |
getFormatCode()
Gets the format code applied to the Y values.
|
java.util.Iterator |
iterator()
Returns an enumerator object.
|
void |
set(int index,
ChartYValue value)
Sets the Y value at the specified index.
|
void |
setFormatCode(java.lang.String value)
Sets the format code applied to the Y values.
|
public java.util.Iterator iterator()
iterator in interface java.lang.Iterablepublic int getCount()
public ChartYValue get(int index)
Remarks:
Empty values are represented as null.
public void set(int index,
ChartYValue value)
Remarks:
Empty values are represented as null.
value - The Y value at the specified index.public java.lang.String getFormatCode()
Remarks:
Number formatting is used to change the way values appears in the chart. 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"
Accounting - "_-\"$\"* #,##0.00_-;-\"$\"* #,##0.00_-;_-\"$\"* \"-\"??_-;_-@_-"
Custom with color - "[Red]-#,##0.0"
Examples:
Shows how to work with the format code of the chart data.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Bubble chart.
Shape shape = builder.insertChart(ChartType.BUBBLE, 432.0, 252.0);
Chart chart = shape.getChart();
// Delete default generated series.
chart.getSeries().clear();
ChartSeries series = chart.getSeries().add(
"Series1",
new double[] { 1.0, 1.9, 2.45, 3.0 },
new double[] { 1.0, -0.9, 1.82, 0.0 },
new double[] { 2.0, 1.1, 2.95, 2.0 });
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowCategoryName(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowBubbleSize(true);
// Set data format codes.
series.getXValues().setFormatCode("#,##0.0#");
series.getYValues().setFormatCode("#,##0.0#;[Red]\\-#,##0.0#");
series.getBubbleSizes().setFormatCode("#,##0.0#");
doc.save(getArtifactsDir() + "Charts.FormatCode.docx");
public void setFormatCode(java.lang.String value)
Remarks:
Number formatting is used to change the way values appears in the chart. 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"
Accounting - "_-\"$\"* #,##0.00_-;-\"$\"* #,##0.00_-;_-\"$\"* \"-\"??_-;_-@_-"
Custom with color - "[Red]-#,##0.0"
Examples:
Shows how to work with the format code of the chart data.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Bubble chart.
Shape shape = builder.insertChart(ChartType.BUBBLE, 432.0, 252.0);
Chart chart = shape.getChart();
// Delete default generated series.
chart.getSeries().clear();
ChartSeries series = chart.getSeries().add(
"Series1",
new double[] { 1.0, 1.9, 2.45, 3.0 },
new double[] { 1.0, -0.9, 1.82, 0.0 },
new double[] { 2.0, 1.1, 2.95, 2.0 });
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowCategoryName(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowBubbleSize(true);
// Set data format codes.
series.getXValues().setFormatCode("#,##0.0#");
series.getYValues().setFormatCode("#,##0.0#;[Red]\\-#,##0.0#");
series.getBubbleSizes().setFormatCode("#,##0.0#");
doc.save(getArtifactsDir() + "Charts.FormatCode.docx");
value - The format code applied to the Y values.