SparklineGroup класс

SparklineGroup класс

Sparkline организован в группу спарклайнов. SparklineGroup содержит переменное количество элементов спарклайна. Группа спарклайнов определяет тип, настройки отображения и настройки осей спарклайнов.

Тип SparklineGroup предоставляет следующие элементы:

Характеристики

СвойствоОписание
preset_styleПолучает и задает предварительно заданный тип стиля группы спарклайнов.
sparkline_collectionПолучает коллекцию объекта Sparkline.
sparklinesПолучает коллекцию объекта Sparkline.
typeУказывает тип спарклайна группы спарклайнов.
plot_empty_cells_typeУказывает, как построить пустые ячейки.
display_hiddenУказывает, следует ли отображать данные в скрытых строках и столбцах.
show_high_pointУказывает, следует ли выделять самые высокие точки данных в группе спарклайнов.
high_point_colorПолучает и задает цвет самых высоких точек данных в группе спарклайнов.
show_low_pointУказывает, следует ли выделять самые низкие точки данных в группе спарклайнов.
low_point_colorПолучает и задает цвет самых низких точек данных в группе спарклайнов.
show_negative_pointsУказывает, следует ли выделять отрицательные значения в группе спарклайнов другим цветом или маркером.
negative_points_colorПолучает и задает цвет отрицательных значений в группе спарклайнов.
show_first_pointУказывает, следует ли выделять первую точку данных в группе спарклайнов.
first_point_colorПолучает и задает цвет первой точки данных в группе спарклайнов.
show_last_pointУказывает, следует ли выделять последнюю точку данных в группе спарклайнов.
last_point_colorПолучает и задает цвет последней точки данных в группе спарклайнов.
show_markersУказывает, следует ли выделять каждую точку в каждой спарклайне в группе спарклайнов.
markers_colorПолучает и задает цвет точек в каждой спарклайне в группе спарклайнов.
series_colorПолучает и задает цвет спарклайнов в группе спарклайнов.
plot_right_to_leftУказывает, расположены ли данные графика справа налево.
line_weightПолучает и задает вес линии в каждой спарклайне в группе спарклайнов в единицах измерения точек.
horizontal_axis_colorПолучает и задает цвет горизонтальной оси в группе спарклайнов.
show_horizontal_axisУказывает, следует ли отображать горизонтальную ось спарклайна.
Горизонтальная ось появляется, если спарклайн содержит данные, пересекающие нулевую ось.
horizontal_axis_date_rangeПредставляет диапазон, содержащий значения дат для данных спарклайна.
vertical_axis_max_value_typeПредставляет тип максимального значения вертикальной оси.
vertical_axis_max_valueПолучает и задает пользовательское максимальное значение для вертикальной оси.
vertical_axis_min_value_typeПредставляет тип минимального значения вертикальной оси.
vertical_axis_min_valueПолучает и задает пользовательское минимальное значение для вертикальной оси.

Методы

МетодОписание
reset_rangesСбрасывает диапазон данных и диапазон местоположений группы спарклайнов.
Этот метод очистит исходные элементы спарклайна в группе и создаст новые элементы спарклайна для новых диапазонов.

Пример

from aspose.cells import CellArea, SaveFormat, Workbook
from aspose.cells.charts import SparklineType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
sheet.cells.get("A1").put_value(5)
sheet.cells.get("B1").put_value(2)
sheet.cells.get("C1").put_value(1)
sheet.cells.get("D1").put_value(3)
#  Define the CellArea
ca = CellArea()
ca.start_column = 4
ca.end_column = 4
ca.start_row = 0
ca.end_row = 0
idx = sheet.sparkline_group_collection.add(SparklineType.LINE, "A1:D1", False, ca)
group = sheet.sparkline_group_collection[idx]
group.sparkline_collection.add(sheet.name + "!A1:D1", 0, 4)
#  Create CellsColor
clr = book.create_cells_color()
clr.color = Color.orange
group.series_color = clr
#  set the high points are colored green and the low points are colored red
group.show_high_point = True
group.show_low_point = True
group.high_point_color.color = Color.green
group.low_point_color.color = Color.red
#  set line weight
group.line_weight = 1.0
book.save("output.xlsx", SaveFormat.XLSX)

Смотрите также