ChartYValue

Inheritance: java.lang.Object

public class ChartYValue

Represents an Y value for a chart series.

Remarks:

This class contains a number of static methods for creating an Y value of a particular type. The getValueType() property allows you to determine the type of an existing Y value.

All non-null Y values of a chart series must be of the same ChartYValueType type.

Methods

MethodDescription
equals(Object obj)Gets a flag indicating whether the specified object is equal to the current Y value object.
fromDateTime(Date value)Creates a ChartYValue instance of the ChartYValueType.DATE_TIME type.
fromDouble(double value)Creates a ChartYValue instance of the ChartYValueType.DOUBLE type.
fromTimeSpan(long value)Creates a ChartYValue instance of the ChartYValueType.TIME type.
getDateTimeValue()Gets the stored datetime value.
getDoubleValue()Gets the stored numeric value.
getTimeValue()Gets the stored time value.
getValueType()Gets the type of the Y value stored in the object.
hashCode()

equals(Object obj)

public boolean equals(Object obj)

Gets a flag indicating whether the specified object is equal to the current Y value object.

Parameters:

ParameterTypeDescription
objjava.lang.Object

Returns: boolean

fromDateTime(Date value)

public static ChartYValue fromDateTime(Date value)

Creates a ChartYValue instance of the ChartYValueType.DATE_TIME type.

Parameters:

ParameterTypeDescription
valuejava.util.Date

Returns: ChartYValue

fromDouble(double value)

public static ChartYValue fromDouble(double value)

Creates a ChartYValue instance of the ChartYValueType.DOUBLE type.

Examples:

Shows how to populate chart series with data.


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

 Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
 Chart chart = shape.getChart();
 ChartSeries series1 = chart.getSeries().get(0);

 // Clear X and Y values of the first series.
 series1.clearValues();

 // Populate the series with data.
 series1.add(ChartXValue.fromDouble(3.0), ChartYValue.fromDouble(10.0));
 series1.add(ChartXValue.fromDouble(5.0), ChartYValue.fromDouble(5.0));
 series1.add(ChartXValue.fromDouble(7.0), ChartYValue.fromDouble(11.0));
 series1.add(ChartXValue.fromDouble(9.0), ChartYValue.fromDouble(17.0));

 ChartSeries series2 = chart.getSeries().get(1);

 // Clear X and Y values of the second series.
 series2.clearValues();

 // Populate the series with data.
 series2.add(ChartXValue.fromDouble(2.0), ChartYValue.fromDouble(4.0));
 series2.add(ChartXValue.fromDouble(4.0), ChartYValue.fromDouble(7.0));
 series2.add(ChartXValue.fromDouble(6.0), ChartYValue.fromDouble(14.0));
 series2.add(ChartXValue.fromDouble(8.0), ChartYValue.fromDouble(7.0));

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

Parameters:

ParameterTypeDescription
valuedouble

Returns: ChartYValue

fromTimeSpan(long value)

public static ChartYValue fromTimeSpan(long value)

Creates a ChartYValue instance of the ChartYValueType.TIME type.

Parameters:

ParameterTypeDescription
valuelong

Returns: ChartYValue

getDateTimeValue()

public Date getDateTimeValue()

Gets the stored datetime value.

Returns: java.util.Date - The stored datetime value.

getDoubleValue()

public double getDoubleValue()

Gets the stored numeric value.

Returns: double - The stored numeric value.

getTimeValue()

public long getTimeValue()

Gets the stored time value.

Returns: long - The stored time value.

getValueType()

public int getValueType()

Gets the type of the Y value stored in the object.

Returns: int - The type of the Y value stored in the object. The returned value is one of ChartYValueType constants.

hashCode()

public int hashCode()

Returns: int