Series класс
Series класс
Инкапсулирует объект, представляющий один ряд данных на диаграмме.
Тип Series предоставляет следующие элементы:
Характеристики
| Свойство | Описание |
|---|---|
| is_filtered | Указывает, выбрана ли серия или отфильтрована. Значение True означает, что эта серия отфильтрована и не будет отображаться на диаграмме. |
| layout_properties | Представляет свойства макета. |
| points | Получает коллекцию точек в серии на диаграмме. |
| area | Представляет фоновую область объекта Series. |
| border | Представляет границу объекта Series. |
| name | Получает или задает имя ряда данных. |
| display_name | Получает имя серии, которое отображается на графике диаграммы. |
| count_of_data_values | Получает количество значений данных. |
| is_vertical_values | Указывает, является ли источник данных вертикальным. |
| values | Представляет данные серии диаграмм. |
| values_format_code | Представляет код формата NumberList Values. |
| x_values | Представляет значения x серии диаграммы. |
| bubble_sizes | Получает или задает значения размеров пузырьков серии диаграмм. |
| trend_lines | Возвращает объект, представляющий коллекцию всех линий тренда для ряда. |
| smooth | Представляет сглаживание кривой. Истинно, если для линейной диаграммы или точечной диаграммы включено сглаживание кривой. Применяется только к линейным и точечным диаграммам, соединенным линиями. |
| 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 | Истинно, если на линейном графике есть полосы вверх и вниз. Применяется только к линейным графикам. |
| 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 | Истинно, если для группы диаграмм показаны отрицательные пузырьки. Действительно только для пузырьковых диаграмм. |
| doughnut_hole_size | Возвращает или задает размер отверстия в группе кольцевых диаграмм. Размер отверстия выражается в процентах от размера диаграммы (от 10 до 90 процентов). |
| explosion | Расстояние открытого фрагмента круговой диаграммы от центра круговой диаграммы выражается в процентах от диаметра круговой диаграммы. |
| has_radar_axis_labels | Истинно, если на лепестковой диаграмме есть метки осей категорий. Применяется только к радиолокационным картам. |
| has_leader_lines | Верно, если в ряду есть линии-выноски. |
| leader_lines | Представляет линии выноски на диаграмме. Линии-выноски соединяют метки данных с точками данных. Этот объект не является коллекцией; нет объекта, который представляет одну линию-выноску. |
| legend_entry | Получает запись легенды согласно этой серии. |
| shape_properties | Получает объект ShapePropertyCollection, содержащий свойства визуальной формы серии. |
Методы
| Метод | Описание |
|---|---|
| move | Перемещает серию вверх или вниз. |
Пример
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
