Series класс
Series класс
Инкапсулирует объект, представляющий отдельную серию данных в диаграмме.
Тип Series предоставляет следующие элементы:
Характеристики
| Свойство | Описание |
|---|---|
| is_filtered | Указывает, выбрана или отфильтрована серия. True означает, что эта серия отфильтрована и не будет отображаться на диаграмме. |
| layout_properties | Представляет свойства макета. |
| points | Получает набор точек в виде серии на диаграмме. |
| area | Представляет фоновую область объекта Series. |
| border | Представляет границу объекта Series. |
| name | Возвращает или задает имя ряда данных. |
| display_name | Получает название серии, отображаемое на графике диаграммы. |
| count_of_data_values | Получает количество значений данных. |
| is_vertical_values | Указывает, является ли источник данных вертикальным. |
| values | Представляет значения Y этой серии диаграмм. |
| values_format_code | Представляет код формата NumberList значений. |
| x_values_format_code | Представляет код формата списка чисел X Values. |
| x_values | Представляет значения x ряда диаграммы. |
| bubble_sizes | Возвращает или задает значения размеров пузырьков в серии диаграммы. |
| trend_lines | Возвращает все линии тренда этой серии. |
| smooth | Представляет собой сглаживание кривой. True, если сглаживание кривых включено для линейной диаграммы или диаграммы рассеяния. Применимо только к линейным и точечным диаграммам, соединенным линиями. |
| shadow | Истина, если у серии есть тень. |
| has_3d_effect | Верно, если серия имеет трехмерный вид. Применимо только к пузырьковым диаграммам. |
| bar_3d_shape_type | Возвращает или задает тип трехмерной фигуры, используемой с трехмерной линейчатой или столбчатой диаграммой. |
| data_labels | Представляет объект DataLabels для указанной ASeries. |
| type | Получает или задает тип ряда данных. |
| marker | Получает Series.marker. |
| plot_on_second_axis | Указывает, отображен ли этот ряд на второй оси значений. |
| x_error_bar | Представляет собой планку погрешности направления X для данной серии. |
| y_error_bar | Представляет собой планку погрешности направления Y для данной серии. |
| has_hi_lo_lines | Истина, если на линейном графике имеются линии максимума и минимума. Применимо только к линейным диаграммам. |
| hi_lo_lines | Возвращает объект HiLoLines, представляющий линии максимума и минимума для ряда на линейном графике. Применимо только к линейным диаграммам. |
| has_series_lines | Истина, если столбчатая диаграмма с накоплением или линейчатая диаграмма имеет линии ряда или если круговая диаграмма или линейчатая круговая диаграмма имеют соединительные линии между двумя секциями. Применимо только к столбчатым диаграммам с накоплением, линейчатым диаграммам, круговым диаграммам или линейчатым круговым диаграммам. |
| series_lines | Возвращает объект SeriesLines, представляющий линии ряда для столбчатой диаграммы с накоплением или столбчатой диаграммы с накоплением. Применимо только к столбчатым и линейчатым диаграммам с накоплением. |
| has_drop_lines | Истина, если на диаграмме есть линии сброса. Применимо только к линейным диаграммам или диаграммам с областями. |
| drop_lines | Возвращает объект Line, представляющий линии отсчета для ряда на линейной диаграмме или диаграмме с областями.Применимо только к линейным диаграммам или диаграммам с областями. |
| has_up_down_bars | True, если линейный график имеет восходящие и нисходящие полосы. Применимо только к линейным диаграммам. |
| up_bars | Возвращает объект DropBars, представляющий восходящие столбцы на линейной диаграмме. Применимо только к линейным диаграммам. |
| down_bars | Возвращает объект DropBars, представляющий нисходящие полосы на линейном графике.Применимо только к линейным диаграммам. |
| is_color_varied | Показывает, является ли цвет точек разным. Диаграмма должна содержать только одну серию. |
| gap_width | Возвращает или задает расстояние между кластерами полос или столбцов в процентах от ширины полосы или столбца. Значение этого свойства должно быть от 0 до 500. |
| first_slice_angle | Возвращает или задает угол первого сектора круговой или кольцевой диаграммы в градусах (по часовой стрелке от вертикали). Применимо только к круговым, трехмерным круговым и кольцевым диаграммам, от 0 до 360. |
| overlap | Определяет, как располагаются полосы и столбцы. Может иметь значение от –100 до 100. Применимо только к двумерным столбчатым и двумерным линейчатым диаграммам. |
| second_plot_size | Возвращает или задает размер вторичной части круговой диаграммы или столбчатой круговой диаграммы. в процентах от размера основного пирога. Может иметь значение от 5 до 200. |
| split_type | Возвращает или задает значение, которое позволяет определить, какие точки данных находятся на второй круговой диаграмме или столбчатой диаграмме круговой диаграммы или столбчатой диаграммы. круговая диаграмма. |
| split_value | Возвращает или задает значение, которое будет использоваться для определения того, какие точки данных находятся во второй круговой или столбчатой диаграмме. круговая диаграмма или столбчатая круговая диаграмма. |
| is_auto_split | Указывает, является ли пороговое значение автоматическим. |
| bubble_scale | Возвращает или задает коэффициент масштабирования для пузырьков в указанной группе диаграммы. Это может быть целое число от 0 (нуля) до 300, соответствующий проценту от размера по умолчанию. Применимо только к пузырьковым диаграммам. |
| size_represents | Возвращает или задает размер пузырька на пузырьковой диаграмме. |
| show_negative_bubbles | True, если для группы диаграмм отображаются отрицательные пузырьки. Действительно только для пузырьковых диаграмм. |
| doughnut_hole_size | Возвращает или задает размер отверстия в группе кольцевых диаграмм. Размер отверстия выражается в процентах от размера диаграммы и составляет от 10 до 90 процентов. |
| explosion | Расстояние от центра круговой диаграммы до открытого сектора круговой диаграммы выражается в процентах от диаметра круга. |
| has_radar_axis_labels | Истина, если на радиальной диаграмме есть метки осей категорий. Применимо только к радиальным диаграммам. |
| has_leader_lines | Истина, если в серии имеются направляющие линии. |
| leader_lines | Представляет собой линии-указатели на диаграмме. Линии-указатели соединяют метки данных с точками данных. Этот объект не является коллекцией; не существует объекта, представляющего отдельную линию-выноску. |
| legend_entry | Получает запись легенды согласно этой серии. |
| shape_properties | Получает объект ShapePropertyCollection, содержащий визуальные свойства формы серии. |
Методы
| Метод | Описание |
|---|---|
move(self, count) | Перемещает серию вверх или вниз. |
Пример
from aspose.cells import Workbook
from aspose.cells.charts import ChartMarkerType, ChartType, FormattingType
from aspose.pydrawing import Color
# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
seriesIndex = chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
series = chart.n_series[seriesIndex]
# Setting the values of the series.
series.values = "=B1:B4"
# Changing the chart type of the series.
series.type = ChartType.LINE
# Setting marker properties.
series.marker.marker_style = ChartMarkerType.CIRCLE
series.marker.foreground_color_set_type = FormattingType.AUTOMATIC
series.marker.foreground_color = Color.black
series.marker.background_color_set_type = FormattingType.AUTOMATIC
# do your business
# Saving the Excel file
workbook.save("book1.xls")
Смотрите также
- модуль
aspose.cells.charts - класс
DropBars - класс
Line - класс
ShapePropertyCollection
