Excel.ChartPoint class

Representa o ponto de uma série do gráfico.

[Conjunto de APIs: ExcelApi 1,1]

Extends

Propriedades

context

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.

dataLabel

Retorna o rótulo de dados de um ponto de gráfico.

[Conjunto de APIs: ExcelApi 1,7]

format

Encapsula as propriedades de formato de um ponto do gráfico.

[Conjunto de APIs: ExcelApi 1,1]

hasDataLabel

Indica se um ponto de dados tem um rótulo de dados. Não aplicável para gráficos de superfície.

[Conjunto de APIs: ExcelApi 1,7]

markerBackgroundColor

Representação do código de cor HTML da cor de plano de fundo do marcador do ponto de dados (por exemplo, # FF0000 representa vermelho).

[Conjunto de APIs: ExcelApi 1,7]

markerForegroundColor

Representação do código de cor HTML da cor de primeiro plano do marcador do ponto de dados (por exemplo, # FF0000 representa vermelho).

[Conjunto de APIs: ExcelApi 1,7]

markerSize

Representa o tamanho do marcador do ponto de dados.

[Conjunto de APIs: ExcelApi 1,7]

markerStyle

Representa estilo do marcador de um ponto de dados do gráfico. Consulte Excel. ChartMarkerStyle para obter detalhes.

[Conjunto de APIs: ExcelApi 1,7]

value

Retorna o valor de um ponto do gráfico.

[Conjunto de APIs: ExcelApi 1,1]

Métodos

load(options)

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

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(propertyNamesAndPaths)

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

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Você pode passar um objeto simples com as propriedades apropriadas ou outro objeto API do mesmo tipo.

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base em um objeto carregado existente.

toJSON()

Substitui o toJSON() método JavaScript para fornecer uma saída mais útil quando um objeto API é passado paraJSON.stringify(). (JSON.stringify, por sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto Excel. ChartPoint original é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado comoExcel.Interfaces.ChartPointData) que contém cópias superficiais de qualquer propriedade filho carregada do objeto original.

Detalhes da propriedade

context

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.

context: RequestContext;

Valor da propriedade

dataLabel

Retorna o rótulo de dados de um ponto de gráfico.

[Conjunto de APIs: ExcelApi 1,7]

readonly dataLabel: Excel.ChartDataLabel;

Valor da propriedade

format

Encapsula as propriedades de formato de um ponto do gráfico.

[Conjunto de APIs: ExcelApi 1,1]

readonly format: Excel.ChartPointFormat;

Valor da propriedade

hasDataLabel

Indica se um ponto de dados tem um rótulo de dados. Não aplicável para gráficos de superfície.

[Conjunto de APIs: ExcelApi 1,7]

hasDataLabel: boolean;

Valor da propriedade

boolean

markerBackgroundColor

Representação do código de cor HTML da cor de plano de fundo do marcador do ponto de dados (por exemplo, # FF0000 representa vermelho).

[Conjunto de APIs: ExcelApi 1,7]

markerBackgroundColor: string;

Valor da propriedade

string

markerForegroundColor

Representação do código de cor HTML da cor de primeiro plano do marcador do ponto de dados (por exemplo, # FF0000 representa vermelho).

[Conjunto de APIs: ExcelApi 1,7]

markerForegroundColor: string;

Valor da propriedade

string

markerSize

Representa o tamanho do marcador do ponto de dados.

[Conjunto de APIs: ExcelApi 1,7]

markerSize: number;

Valor da propriedade

number

markerStyle

Representa estilo do marcador de um ponto de dados do gráfico. Consulte Excel. ChartMarkerStyle para obter detalhes.

[Conjunto de APIs: ExcelApi 1,7]

markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";

Valor da propriedade

Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"

value

Retorna o valor de um ponto do gráfico.

[Conjunto de APIs: ExcelApi 1,1]

readonly value: any;

Valor da propriedade

any

Detalhes do método

load(options)

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

load(options?: Excel.Interfaces.ChartPointLoadOptions): Excel.ChartPoint;

Parâmetros

options
Excel.Interfaces.ChartPointLoadOptions

Fornece opções para as propriedades do objeto a ser carregado.

Retornos

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[]): Excel.ChartPoint;

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

load(propertyNamesAndPaths)

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

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.ChartPoint;

Parâmetros

propertyNamesAndPaths
{ select?: string; expand?: string; }

propertyNamesAndPaths.selecté uma cadeia de caracteres delimitada por vírgula que especifica as propriedades a serem carregadas e propertyNamesAndPaths.expand é uma cadeia de caracteres delimitada por vírgula que especifica as propriedades de navegação a serem carregadas.

Retornos

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Você pode passar um objeto simples com as propriedades apropriadas ou outro objeto API do mesmo tipo.

set(properties: Interfaces.ChartPointUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parâmetros

properties
Interfaces.ChartPointUpdateData

Um objeto JavaScript com propriedades que são estruturadas isomorphically para as propriedades do objeto no qual o método é chamado.

options
OfficeExtension.UpdateOptions

Fornece uma opção para suprimir erros se o objeto Properties tentar definir qualquer propriedade somente leitura.

Retornos

void

Comentários

Este método tem a seguinte assinatura adicional:

set(properties: Excel.ChartPoint): void

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base em um objeto carregado existente.

set(properties: Excel.ChartPoint): void;

Parâmetros

properties
Excel.ChartPoint

Retornos

void

toJSON()

Substitui o toJSON() método JavaScript para fornecer uma saída mais útil quando um objeto API é passado paraJSON.stringify(). (JSON.stringify, por sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto Excel. ChartPoint original é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado comoExcel.Interfaces.ChartPointData) que contém cópias superficiais de qualquer propriedade filho carregada do objeto original.

toJSON(): Excel.Interfaces.ChartPointData;

Retornos