Excel.ChartTrendline interface

Este objeto representa os atributos de um objeto Trendline de gráfico.

Propriedades

backwardPeriod

Representa o número de períodos que a linha de tendência se estende para trás.

format

Representa a formatação de uma linha de tendência do gráfico.

forwardPeriod

Representa o número de períodos que a linha de tendência se estende para frente.

intercept

Representa o valor de intercepção da linha de tendência. Pode ser definido como um valor numérico ou uma cadeia de caracteres vazia (para valores automáticos de eixo). O valor retornado sempre é um número.

label

Representa o rótulo de linha de tendência um gráfico.

movingAveragePeriod

Representa o período de uma tendência de gráfico. Aplicável somente para tendência com tipo MovingAverage.

name

Representa o nome da linha de tendência. Pode ser definido como um valor de sequência ou pode ser definido como valor nulo para representar valores automáticos. O valor retornado sempre é uma cadeia de caracteres.

polynomialOrder

Representa a ordem de uma tendência de gráfico. Aplicável somente para tendência com tipo polinomial.

showEquation

Verdadeiro se a equação da linha de tendência for exibida no gráfico.

showRSquared

Verdadeiro se o R-quadrado da linha de tendência for exibido no gráfico.

type

Representa o tipo da linha de tendência de um gráfico.

Métodos

delete()

Deleta o objeto Trendline.

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

Detalhes da propriedade

backwardPeriod

Representa o número de períodos que a linha de tendência se estende para trás.

backwardPeriod: number;

Valor da propriedade

number

format

Representa a formatação de uma linha de tendência do gráfico.

readonly format: ChartTrendlineFormat;

Valor da propriedade

forwardPeriod

Representa o número de períodos que a linha de tendência se estende para frente.

forwardPeriod: number;

Valor da propriedade

number

intercept

Representa o valor de intercepção da linha de tendência. Pode ser definido como um valor numérico ou uma cadeia de caracteres vazia (para valores automáticos de eixo). O valor retornado sempre é um número.

intercept: any;

Valor da propriedade

any

label

Representa o rótulo de linha de tendência um gráfico.

readonly label: ChartTrendlineLabel;

Valor da propriedade

movingAveragePeriod

Representa o período de uma tendência de gráfico. Aplicável somente para tendência com tipo MovingAverage.

movingAveragePeriod: number;

Valor da propriedade

number

name

Representa o nome da linha de tendência. Pode ser definido como um valor de sequência ou pode ser definido como valor nulo para representar valores automáticos. O valor retornado sempre é uma cadeia de caracteres.

name: string;

Valor da propriedade

string

polynomialOrder

Representa a ordem de uma tendência de gráfico. Aplicável somente para tendência com tipo polinomial.

polynomialOrder: number;

Valor da propriedade

number

showEquation

Verdadeiro se a equação da linha de tendência for exibida no gráfico.

showEquation: boolean;

Valor da propriedade

boolean

showRSquared

Verdadeiro se o R-quadrado da linha de tendência for exibido no gráfico.

showRSquared: boolean;

Valor da propriedade

boolean

type

Representa o tipo da linha de tendência de um gráfico.

type:
            | ChartTrendlineType
            | "Linear"
            | "Exponential"
            | "Logarithmic"
            | "MovingAverage"
            | "Polynomial"
            | "Power";

Valor da propriedade

| ChartTrendlineType | "Linear" | "Exponential" | "Logarithmic" | "MovingAverage" | "Polynomial" | "Power"

Exemplos

async function main(context: Excel.RequestContext) {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let seriesCollection = sheet.charts.getItemAt(0).series;

    // Get the trendline for series 1 and load its type property.  
    let trendline = seriesCollection.getItemAt(0).trendlines.getItem(0);
    trendline.load("type");

    await context.sync();

    console.log("The trendline type is:" + trendline.type);  
}

Detalhes do método

delete()

Deleta o objeto Trendline.

delete(): void;

Retornos

void

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): void;

Parâmetros

propertyNames
string | string[]

Uma cadeia de caracteres delimitada por vírgula ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

void