Classe Trendline (Excel VBA)

A classe Trendline representa uma linha de tendência em um gráfico.

Os principais procedimentos da classe Trendline são Delete, Select e Trendlines.Add

Set

Para usar uma variável de classe Trendline, ela primeiro precisa ser instanciada por exemplo

Dim trnln as Trendline
Set trnln = ActiveChart.FullSeriesCollection(1).Trendlines(Index:=1)

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo Trendline: Trendlines.Item, Trendlines.Add e Series.Trendlines

For Each

Aqui está um exemplo de processamento dos itens Trendline em uma coleção.

Dim trnln As Trendline
For Each trnln In ActiveChart.FullSeriesCollection(1).Trendlines()
	
Next trnln

Temas

Os procedimentos a seguir nesta aula foram agrupados e são descritos em uma página de tema separada

Display/Show with its procedures DisplayEquation e DisplayRSquared

Métodos

Estes são os principais métodos da classe Trendline

Delete - Exclui o objeto.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Delete

Select - Seleciona o objeto.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Select

Trendlines.Add - Cria uma nova linha de tendência.

Dim trnln As Trendline
Set trnln = ActiveChart.FullSeriesCollection(1).Trendlines.Add

Estes são os principais métodos da classe

ClearFormats - Limpa a formatação do objeto.

Trendlines.Item - Retorna um único objeto de uma coleção.

Propriedades

Backward2 Retorna ou define o número de períodos ou unidades em um gráfico de dispersão pelos quais a linha de tendência se estende para trás. Double de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Backward2 =

Border Retorna um objeto Border que representa a borda do objeto.

Dim brdBorder As Border
Set brdBorder = ActiveChart.FullSeriesCollection(1).Trendlines(1).Border

DataLabel Retorna um objeto DataLabel que representa o rótulo de dados associado à trendline. Somente leitura.

Dim dtlDataLabel As DataLabel
Set dtlDataLabel = ActiveChart.FullSeriesCollection(1).Trendlines(1).DataLabel

Format Retorna o objeto ChartFormat . Somente leitura.

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveChart.FullSeriesCollection(1).Trendlines(1).Format

Forward2 Retorna ou define o número de períodos ou unidades em um gráfico de dispersão que a linha de tendência se estende para frente. Double de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Forward2 =

Index Retorna um valor Long que representa o número de índice do objeto dentro da coleção de objetos semelhantes.

Dim lngIndex As Long
lngIndex = ActiveChart.FullSeriesCollection(1).Trendlines(1).Index

Intercept Retorna ou define o ponto onde a linha de tendência cruza o eixo dos valores. Double de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Intercept =

InterceptIsAuto True se o ponto onde a linha de tendência cruza o eixo dos valores for determinado automaticamente pela regressão. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).InterceptIsAuto = True

Name Retorna ou define um valor String que representa o nome do objeto.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Name =

NameIsAuto True se o Microsoft Excel determinar automaticamente o nome da linha de tendência. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).NameIsAuto = True

Order Retorna ou define um valor Long que representa a ordem da tendência um inteiro maior que 1 quando o tipo de tendência é xlPolynomial (XlTrendlineType).

ActiveChart.FullSeriesCollection(1).Trendlines(1).Order =

Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveChart.FullSeriesCollection(1).Trendlines(1).Parent

Period Retorna ou define o período para a linha de tendência de média móvel. Pode ser um valor de 2 a 255. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Period =

Type Retorna ou define um valor XlTrendlineType que representa o tipo de tendência.

ActiveChart.FullSeriesCollection(1).Trendlines(1).Type = xlExponential

Trendlines.Count Retorna um valor Long que representa o número de objetos na coleção.

Dim lngCount As Long
lngCount = ActiveChart.FullSeriesCollection(1).Trendlines.Count

Trendlines.Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveChart.FullSeriesCollection(1).Trendlines.Parent