ChartDataPoint
Contents
[
Hide
]
ChartDataPoint class
Allows to specify formatting of a single data point on the chart.
public class ChartDataPoint : IChartDataPoint
Properties
Name | Description |
---|---|
Bubble3D { get; set; } | |
Explosion { get; set; } | |
Format { get; } | Provides access to fill and line formatting of this data point. |
Index { get; } | Index of the data point this object applies formatting to. |
InvertIfNegative { get; set; } | |
Marker { get; } |
Methods
Name | Description |
---|---|
ClearFormat() | Clears format of this data point. The properties are set to the default values defined in the parent series. |
Remarks
On a series, the ChartDataPoint
object is a member of the ChartDataPointCollection
. The ChartDataPointCollection
contains a ChartDataPoint
object for each point.
Examples
Shows how to work with data points on a line chart.
[Test]
public void ChartDataPoint()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 500, 350);
Chart chart = shape.Chart;
Assert.AreEqual(3, chart.Series.Count);
Assert.AreEqual("Series 1", chart.Series[0].Name);
Assert.AreEqual("Series 2", chart.Series[1].Name);
Assert.AreEqual("Series 3", chart.Series[2].Name);
// Emphasize the chart's data points by making them appear as diamond shapes.
foreach (ChartSeries series in chart.Series)
ApplyDataPoints(series, 4, MarkerSymbol.Diamond, 15);
// Smooth out the line that represents the first data series.
chart.Series[0].Smooth = true;
// Verify that data points for the first series will not invert their colors if the value is negative.
using (IEnumerator<ChartDataPoint> enumerator = chart.Series[0].DataPoints.GetEnumerator())
{
while (enumerator.MoveNext())
{
Assert.False(enumerator.Current.InvertIfNegative);
}
}
// For a cleaner looking graph, we can clear format individually.
chart.Series[1].DataPoints[2].ClearFormat();
// We can also strip an entire series of data points at once.
chart.Series[2].DataPoints.ClearFormat();
doc.Save(ArtifactsDir + "Charts.ChartDataPoint.docx");
}
/// <summary>
/// Applies a number of data points to a series.
/// </summary>
private static void ApplyDataPoints(ChartSeries series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
for (int i = 0; i < dataPointsCount; i++)
{
ChartDataPoint point = series.DataPoints[i];
point.Marker.Symbol = markerSymbol;
point.Marker.Size = dataPointSize;
Assert.AreEqual(i, point.Index);
}
}
See Also
- interface IChartDataPoint
- namespace Aspose.Words.Drawing.Charts
- assembly Aspose.Words