Compartilhar via


Excel.ChartPoint class

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

Extends

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

Propriedades

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

dataLabel

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

format

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

hasDataLabel

Representa se um ponto de dados tem uma etiqueta de dados. Não aplicável para gráficos de superfície.

markerBackgroundColor

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

markerForegroundColor

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

markerSize

Representa o tamanho do marcador de um ponto de dados. O intervalo de tamanho suportado é de 2 a 72. Este método devolve um erro InvalidArgument se estiver definido com um tamanho fora do intervalo suportado.

markerStyle

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

value

Retorna o valor de um ponto do gráfico.

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. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties)

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

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto Excel.ChartPoint original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.ChartPointData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

Detalhes da propriedade

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

dataLabel

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

readonly dataLabel: Excel.ChartDataLabel;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

format

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

readonly format: Excel.ChartPointFormat;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

hasDataLabel

Representa se um ponto de dados tem uma etiqueta de dados. Não aplicável para gráficos de superfície.

hasDataLabel: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

markerBackgroundColor

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

markerBackgroundColor: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

markerForegroundColor

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

markerForegroundColor: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

markerSize

Representa o tamanho do marcador de um ponto de dados. O intervalo de tamanho suportado é de 2 a 72. Este método devolve um erro InvalidArgument se estiver definido com um tamanho fora do intervalo suportado.

markerSize: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

markerStyle

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

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"

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

value

Retorna o valor de um ponto do gráfico.

readonly value: any;

Valor da propriedade

any

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

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 carregar.

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 delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.

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 delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.

Retornos

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

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

Parâmetros

properties
Excel.Interfaces.ChartPointUpdateData

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

options
OfficeExtension.UpdateOptions

Fornece uma opção para suprimir erros se o objeto de propriedades tentar definir quaisquer propriedades só de leitura.

Retornos

void

set(properties)

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

set(properties: Excel.ChartPoint): void;

Parâmetros

properties
Excel.ChartPoint

Retornos

void

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto Excel.ChartPoint original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.ChartPointData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Excel.Interfaces.ChartPointData;

Retornos