ChartSeries
Содержание
[
Скрывать
]ChartSeries class
Представляет свойства серии диаграмм.
Чтобы узнать больше, посетитеРабота с диаграммами статья документации.
public class ChartSeries : IChartDataPoint
Характеристики
Имя | Описание |
---|---|
Bubble3D { get; set; } | Указывает, должен ли к пузырькам на пузырьковой диаграмме применяться трехмерный эффект. |
BubbleSizes { get; } | Получает коллекцию размеров пузырьков для этой серии диаграмм. |
DataLabels { get; } | Указывает настройки меток данных для всей серии. |
DataPoints { get; } | Возвращает коллекцию объектов форматирования для всех точек данных в этой серии. |
Explosion { get; set; } | Указывает, на сколько точка данных должна быть перемещена из центра круговой диаграммы. Может быть отрицательным. Отрицательное значение означает, что свойство не установлено и не следует применять развертывание. Применяется только к круговым диаграммам. |
Format { get; } | Предоставляет доступ к заливке и форматированию строк серии. |
HasDataLabels { get; set; } | Получает или задает флаг, указывающий, отображаются ли метки данных для серии. |
InvertIfNegative { get; set; } | Указывает, должен ли родительский элемент инвертировать свои цвета, если значение отрицательное. |
LegendEntry { get; } | Получает запись легенды для этой серии диаграмм. |
Marker { get; } | Указывает маркер данных. Маркер создается автоматически по запросу. |
Name { get; set; } | Получает или задает имя серии. Если имя не задано явно, оно генерируется с использованием индекса. По умолчанию возвращает серию плюс один индекс на основе индекса. |
SeriesType { get; } | Получает тип этой серии диаграмм. |
Smooth { get; set; } | Позволяет указать, должна ли линия, соединяющая точки на диаграмме, сглаживаться с использованием сплайнов Catmull-Rom. |
XValues { get; } | Получает коллекцию значений X для этой серии диаграмм. |
YValues { get; } | Получает коллекцию значений Y для этой серии диаграмм. |
Методы
Имя | Описание |
---|---|
Add(ChartXValue) | Добавляет указанное значение X в серию диаграмм. Если серия поддерживает значения Y и размеры пузырьков, они будут пустыми для значения X. |
Add(ChartXValue, ChartYValue) | Добавляет указанные значения X и Y в серию диаграмм. |
Add(ChartXValue, ChartYValue, double) | Добавляет указанное значение X, значение Y и размер пузырька в серию диаграмм. |
Clear() | Удаляет все значения данных из серии диаграмм. Формат всех отдельных точек данных и меток данных очищается. |
ClearValues() | Удаляет все значения данных из серии диаграмм с сохранением формата точек данных и меток данных. |
Insert(int, ChartXValue) | Вставляет указанное значение X в серию диаграмм по указанному индексу. Если серия поддерживает значения Y и размеры пузырьков, они будут пустыми для значения X. |
Insert(int, ChartXValue, ChartYValue) | Вставляет указанные значения X и Y в серию диаграмм по указанному индексу. |
Insert(int, ChartXValue, ChartYValue, double) | Вставляет указанное значение X, значение Y и размер пузырька в серию диаграмм по указанному индексу. |
Remove(int) | Удаляет значение X, значение Y и размер пузырька, если поддерживается, из серии диаграмм по указанному индексу. Соответствующая точка данных и метка данных также удаляются. |
Примеры
Показывает, как применять метки к точкам данных на линейной диаграмме.
public void DataLabels()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300);
Chart chart = chartShape.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);
// Применяем метки данных к каждой серии диаграммы.
// Эти метки появятся рядом с каждой точкой данных на графике и отобразят ее значение.
foreach (ChartSeries series in chart.Series)
{
ApplyDataLabels(series, 4, "000.0", ", ");
Assert.AreEqual(4, series.DataLabels.Count);
}
// Измените строку-разделитель для каждой метки данных в серии.
using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
{
while (enumerator.MoveNext())
{
Assert.AreEqual(", ", enumerator.Current.Separator);
enumerator.Current.Separator = " & ";
}
}
// Чтобы график выглядел чище, мы можем удалить метки данных по отдельности.
chart.Series[1].DataLabels[2].ClearFormat();
// Мы также можем сразу удалить целую серию меток данных.
chart.Series[2].DataLabels.ClearFormat();
doc.Save(ArtifactsDir + "Charts.DataLabels.docx");
}
/// <summary>
/// Примените метки данных с произвольным числовым форматом и разделителем к нескольким точкам данных в серии.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
for (int i = 0; i < labelsCount; i++)
{
series.HasDataLabels = true;
Assert.False(series.DataLabels[i].IsVisible);
series.DataLabels[i].ShowCategoryName = true;
series.DataLabels[i].ShowSeriesName = true;
series.DataLabels[i].ShowValue = true;
series.DataLabels[i].ShowLeaderLines = true;
series.DataLabels[i].ShowLegendKey = true;
series.DataLabels[i].ShowPercentage = false;
series.DataLabels[i].IsHidden = false;
Assert.False(series.DataLabels[i].ShowDataLabelsRange);
series.DataLabels[i].NumberFormat.FormatCode = numberFormat;
series.DataLabels[i].Separator = separator;
Assert.False(series.DataLabels[i].ShowDataLabelsRange);
Assert.True(series.DataLabels[i].IsVisible);
Assert.False(series.DataLabels[i].IsHidden);
}
}
Смотрите также
- interface IChartDataPoint
- пространство имен Aspose.Words.Drawing.Charts
- сборка Aspose.Words