Series класс
Series класс
Инкапсулирует объект, представляющий один ряд данных на диаграмме.
Тип Series предоставляет следующие члены:
Характеристики
| Свойство | Описание |
|---|---|
| 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 | Представляет сглаживание кривой.
Значение true, если сглаживание кривой включено для линейной диаграммы или точечной диаграммы. Применяется только к линейным и точечным графикам, связанным линиями. |
| shadow | Истинно, если у серии есть тень. |
| has_3d_effect | Верно, если сериал имеет трехмерный вид.
Применяется только к пузырьковым диаграммам. |
| bar_3d_shape_type | Получает или задает тип трехмерной фигуры, используемый с трехмерной гистограммой или гистограммой. |
| bar_shape | Получает или задает тип трехмерной фигуры, используемый с трехмерной гистограммой или гистограммой. |
| data_labels | Представляет объект DataLabels для указанного ASeries. |
| type | Получает или задает тип ряда данных. |
| marker | Получает Series.marker. |
| plot_on_second_axis | Указывает, нанесен ли этот ряд на вторую ось значений. |
| x_error_bar | Представляет линейку погрешностей направления X ряда. |
| y_error_bar | Представляет полосу погрешности направления Y ряда. |
| has_hi_lo_lines | True, если на линейном графике есть линии максимума-минимума.
Применяется только к линейным графикам. |
| hi_lo_lines | Возвращает объект HiLoLines, представляющий линии максимума и минимума для ряда на линейной диаграмме.
Применяется только к линейным графикам. |
| has_series_lines | Значение true, если столбчатая диаграмма с накоплением или линейчатая диаграмма содержит ряды линий или
если круговая диаграмма или гистограмма имеет соединительные линии между двумя разделами. Применяется только к столбчатым диаграммам с накоплением, столбчатым диаграммам, круговым диаграммам или столбчатым круговым диаграммам. |
| 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 | Значение true, если лепестковая диаграмма имеет метки оси категорий. Применяется только к радиолокационным картам. |
| has_leader_lines | Истинно, если ряд имеет линии выноски. |
| leader_lines | Представляет линии выноски на диаграмме. Линии выноски соединяют метки данных с точками данных.
Этот объект не является коллекцией; нет объекта, представляющего одну линию выноски. |
| legend_entry | Получает запись легенды в соответствии с этой серией. |
| shape_properties | Получает объект ShapePropertyCollection, содержащий свойства визуальной формы Series. |
Методы
| Метод | Описание |
|---|---|
| move(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
