Trendline класс

Trendline класс

Представляет линию тренда на диаграмме.

Наследование: Trendline → Line

Тип Trendline предоставляет следующие члены:

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

Свойство Описание
compound_type Задает тип составной линии
dash_type Указывает тип пунктирной линии
cap_type Определяет конечные заглавные буквы.
join_type Определяет соединительные заглавные буквы.
begin_type Указывает стрелку для начала строки.
end_type Задает стрелку для конца строки.
begin_arrow_length Определяет длину стрелки для начала строки.
end_arrow_length Задает длину стрелки для конца строки.
begin_arrow_width Определяет ширину стрелки для начала строки.
end_arrow_width Определяет ширину стрелки для конца строки.
theme_color Получает и задает цвет темы.
color Представляет цвет линии.
transparency Возвращает или задает степень прозрачности линии в виде значения от 0,0 (непрозрачная) до 1,0 (прозрачная).
style Представляет стиль линии.
weight Получает или задает WeightType строки.
weight_pt Получает или задает вес линии в пунктах.
weight_px Получает или задает вес линии в пикселях.
formatting_type Получает или задает тип формата.
is_automatic_color Указывает, назначается ли цвет линии автоматически.
is_visible Указывает, видна ли линия.
is_auto Указывает, назначается ли этот стиль линии автоматически.
gradient_fill Представляет градиентную заливку.
is_name_auto Возвращает, если Microsoft Excel автоматически определяет имя линии тренда.
type Возвращает тип линии тренда.
name Возвращает имя линии тренда.
order Возвращает или задает порядок линии тренда (целое число больше 1), если тип линии тренда полиномиальный.
Порядок должен быть от 2 до 6.
period Возвращает или задает период для линии тренда скользящей средней.
forward Возвращает или задает количество периодов (или единиц на точечной диаграмме), на которое линия тренда продолжается вперед.
Количество периодов должно быть больше или равно нулю.
backward Возвращает или задает количество периодов (или единиц на точечной диаграмме), на которые линия тренда тянется назад.
Количество периодов должно быть больше или равно нулю.
Если тип диаграммы — столбец, количество периодов должно быть от 0 до 0,5.
display_equation Указывает, отображается ли уравнение для линии тренда на диаграмме (в той же метке данных, что и значение R-квадрата). Установка для этого свойства значения True автоматически включает метки данных.
display_r_squared Указывает, отображается ли на диаграмме значение R-квадрата линии тренда (в той же метке данных, что и уравнение). Установка для этого свойства значения True автоматически включает метки данных.
intercept Возвращает или задает точку, в которой линия тренда пересекает ось значений.
data_labels Представляет объект DataLabels для указанной серии.
legend_entry Получает запись легенды в соответствии с этой линией тренда

Пример

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, TrendlineType

# 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"
chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
# adding a linear trendline
index = chart.n_series[0].trend_lines.add(TrendlineType.LINEAR)
trendline = chart.n_series[0].trend_lines[index]
# Setting the custom name of the trendline.
trendline.name = "Linear"
# Displaying the equation on chart
trendline.display_equation = True
# Displaying the R-Squared value on chart
trendline.display_r_squared = True
# Saving the Excel file
workbook.save("book1.xls")

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

Title класс TrendlineCollection класс