Excel.ChartSeries class

Especifica o grupo da série especificada.

axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Encapsula as opções de bin para gráficos de histograma e gráficos de pareto.

readonly binOptions: Excel.ChartBinOptions;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Encapsula as opções para os gráficos de caixa estreita.

readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Este pode ser um valor inteiro de 0 (zero) a 300, representando a porcentagem do tamanho padrão. Esta propriedade só se aplica a gráficos de bolhas.

bubbleScale: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Representa o tipo de gráfico de uma série. Consulte Excel.ChartType para obter detalhes.

chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

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

Representa uma coleção de todos os rótulos de dados da série.

readonly dataLabels: Excel.ChartDataLabels;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Representa o tamanho do furo de rosca de uma série de gráficos. Válido apenas em gráficos de rosca e rosca explodida. Gera um InvalidArgument erro em gráficos inválidos.

doughnutHoleSize: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica o valor de explosão para uma fatia de gráfico de pizza ou gráfico de rosca. Retorna 0 (zero) se não houver explosão (a ponta da fatia está no centro da pizza).

explosion: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Especifica se a série é filtrada. Não aplicável para gráficos de superfície.

filtered: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica o ângulo da primeira fatia do gráfico de pizza ou gráfico de rosca, em graus (no sentido horário a partir da vertical). Aplica-se apenas a pizza, torta 3-D e gráficos de rosca.. Pode ser um valor de 0 a 360.

firstSliceAngle: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Representa a formatação de uma série do gráfico, que inclui a formatação de linha e de preenchimento.

readonly format: Excel.ChartSeriesFormat;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.1]

Representa a largura do espaçamento de uma série de gráfico. Válido apenas em gráficos de barras e colunas, bem como classes específicas de gráficos de linhas e de pizza. Lança uma exceção de argumento inválido em gráficos inválidos.

gapWidth: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica a cor do valor máximo de uma série de gráficos de mapa de regiões.

gradientMaximumColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o tipo de valor máximo de uma série de gráficos de mapa de regiões.

gradientMaximumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o valor máximo de uma série de gráficos de mapa de regiões.

gradientMaximumValue: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica a cor do valor do ponto médio de uma série de gráficos de mapa de regiões.

gradientMidpointColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o tipo do valor do ponto médio de uma série de gráficos de mapa de regiões.

gradientMidpointType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o valor do ponto médio de uma série de gráficos de mapa de regiões.

gradientMidpointValue: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica a cor do valor mínimo de uma série de gráficos de mapa de regiões.

gradientMinimumColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o tipo do valor mínimo de uma série de gráficos de mapa de regiões.

gradientMinimumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o valor mínimo de uma série de gráficos de mapa de regiões.

gradientMinimumValue: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica o estilo de gradiente de série de um gráfico de mapa de regiões.

gradientStyle: Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica se a série tem rótulos de dados.

hasDataLabels: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica a cor de preenchimento para pontos de dados negativos em uma série.

invertColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

True se o Excel inverter o padrão no item quando ele corresponde a um número negativo.

invertIfNegative: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Encapsula as opções para um gráfico de mapa de região.

readonly mapOptions: Excel.ChartMapOptions;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica a cor de plano de fundo do marcador de uma série de gráficos.

markerBackgroundColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica a cor do primeiro plano do marcador de uma série de gráficos.

markerForegroundColor: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica o tamanho do marcador de uma série de gráficos. O intervalo de tamanho com suporte é de 2 a 72. Esse método retornará um erro InvalidArgument se ele estiver definido com um tamanho fora do intervalo com suporte.

markerSize: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica o estilo do marcador de uma série de gráficos. Consulte Excel.ChartMarkerStyle para obter detalhes.

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

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica o nome de uma série em um gráfico. O comprimento do nome não deve ser maior que 255 caracteres.

name: string;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.1]

Especifica como barras e colunas são posicionadas. Pode ser um valor entre -100 e 100. Se aplicam apenas às barras 2D e gráficos de colunas 2D.

overlap: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Especifica a área de estratégia do rótulo pai da série para um gráfico de mapa de árvore.

parentLabelStrategy: Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica a ordem de plotagem de uma série de gráficos dentro do grupo de gráficos.

plotOrder: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Retorna uma coleção de todos os pontos da série.

readonly points: Excel.ChartPointsCollection;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.1]

Especifica o tamanho da seção secundária de um gráfico de pizza ou de barra de pizza como uma porcentagem do tamanho da pizza principal. Pode ser um valor de 5 de 200.

secondPlotSize: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Especifica se as linhas de conexão são mostradas em gráficos em cascata.

showConnectorLines: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica se as linhas de preenchimento são exibidas para cada rótulo de dados na série.

showLeaderLines: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Especifica se a série tem uma sombra.

showShadow: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica se a série é suave. Aplicável apenas a gráficos de linhas e gráficos de dispersão.

smooth: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Especifica a forma como as duas seções de um gráfico de pizza ou de barra são divididas.

splitType: Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit";

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Especifica o valor limite que separa duas seções de um gráfico de pizza ou de barra de pizza.

splitValue: number;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

A coleção de linhas de tendência da série.

readonly trendlines: Excel.ChartTrendlineCollection;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.7]

Verdadeiro se o Excel atribuir uma cor ou padrão diferente a cada marcador de dados. O gráfico deve conter apenas uma série.

varyByCategories: boolean;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.8]

Representa o objeto da barra de erros de uma série de gráficos.

readonly xErrorBars: Excel.ChartErrorBars;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Representa o objeto da barra de erros de uma série de gráficos.

readonly yErrorBars: Excel.ChartErrorBars;

Valor da propriedade

Comentários

[Conjunto de apis: ExcelApi 1.9]

Exclui a série de gráfico.

delete(): void;

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.7]

Obtém a representação da cadeia de caracteres da fonte de dados da série do gráfico. A representação de cadeia de caracteres pode ser uma informação, como um endereço de célula.

getDimensionDataSourceString(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.15]

Obtém a representação da cadeia de caracteres da fonte de dados da série do gráfico. A representação de cadeia de caracteres pode ser uma informação, como um endereço de célula.

getDimensionDataSourceString(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.15]

Obtém o tipo de fonte de dados da série de gráficos.

getDimensionDataSourceType(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.15]

Obtém o tipo de fonte de dados da série de gráficos.

getDimensionDataSourceType(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.15]

Obtém os valores de uma única dimensão da série do gráfico. Podem ser valores de categoria ou valores de dados, dependendo da dimensão especificada e de como os dados são mapeados para a série de gráficos.

getDimensionValues(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string[]>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.12]

Obtém os valores de uma única dimensão da série do gráfico. Podem ser valores de categoria ou valores de dados, dependendo da dimensão especificada e de como os dados são mapeados para a série de gráficos.

getDimensionValues(dimension: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string[]>;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.12]

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.ChartSeriesLoadOptions): Excel.ChartSeries;

Parâmetros

Retornos

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.ChartSeries;

Parâmetros

Retornos

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.ChartSeries;

Parâmetros

Retornos

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

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

Parâmetros

Retornos

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

set(properties: Excel.ChartSeries): void;

Parâmetros

Retornos

Define os tamanhos das bolhas para uma série de gráficos. Funciona apenas para gráficos de bolhas.

setBubbleSizes(sourceData: Range | string): void;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.7 para a sobrecarga de intervalo; 1.21 para a sobrecarga de cadeia de caracteres de fórmula.]

Define os valores de uma série de gráficos. Para gráficos de dispersão, refere-se aos valores do eixo y.

setValues(sourceData: Range | string): void;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.7 para a sobrecarga de intervalo; 1.21 para a sobrecarga de cadeia de caracteres de fórmula.]

Define os valores do eixo x para uma série de gráficos.

setXAxisValues(sourceData: Range | string): void;

Parâmetros

Retornos

Comentários

[Conjunto de apis: ExcelApi 1.7 para a sobrecarga de intervalo; 1.21 para a sobrecarga de cadeia de caracteres de fórmula.]

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é passado para JSON.stringify(). (JSON.stringify, por sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto original Excel.ChartSeries é um objeto de API, o toJSON método retorna um objeto JavaScript simples (digitado como Excel.Interfaces.ChartSeriesData) que contém cópias superficiais de todas as propriedades filho carregadas do objeto original.

toJSON(): Excel.Interfaces.ChartSeriesData;

Retornos