ExcelScript.ChartSeries interface

Referencia

Paquete:: ExcelScript

Representa una serie de un gráfico.

Comentarios

Ejemplos

/**
 * This sample produces a line chart with two series.
 * The chart assumes data in A1:E5 that looks like this:
 * Product Qtr1 Qtr2 Qtr3 Qtr4
 * Frames 5000 7000 6544 4377
 * Saddles 400 323 276 651
 */
function main(workbook: ExcelScript.Workbook) {
  // Establish the ranges to use.
  const sheet = workbook.getActiveWorksheet();
  const headerRange = sheet.getRange("A1:E1");
  const firstSeriesRange = sheet.getRange("A2:E2");
  const secondSeriesRange = sheet.getRange("A3:E3");

  // Create the chart.
  const lineChart = sheet.addChart(ExcelScript.ChartType.line, headerRange);

  // Add the first chart series.
  const firstSeries = lineChart.addChartSeries();
  firstSeries.setXAxisValues(headerRange);
  firstSeries.setValues(firstSeriesRange);

  // Add the second chart series.
  const secondSeries = lineChart.addChartSeries();
  secondSeries.setXAxisValues(headerRange);
  secondSeries.setValues(secondSeriesRange);
}

Métodos

addChartTrendline(type)	Agrega una nueva línea de tendencia a la colección de líneas de tendencia.
delete()	Elimina la serie del gráfico.
getAxisGroup()	Especifica el grupo de la serie especificada.
getBinOptions()	Contiene las opciones de intervalo para gráficos de histograma y diagramas de Pareto.
getBoxwhiskerOptions()	Contiene las opciones para el gráfico de cajas y bigotes.
getBubbleScale()	Esto puede ser un valor entero entre 0 (cero) y 300, que representa el porcentaje del tamaño predeterminado. Esta propiedad solo se aplica a los gráficos de burbujas.
getChartTrendline(index)	Obtiene un objeto de línea de tendencia por índice, que es el orden de inserción en la matriz de elementos.
getChartType()	Representa el tipo de gráfico de una serie. Vea `ExcelScript.ChartType` para más información.
getDataLabels()	Representa una colección de todas las etiquetas de datos de la serie.
getDimensionDataSourceString(dimension)	Obtiene la representación de cadena del origen de datos de la serie de gráficos. La representación de cadena podría ser información como una dirección de celda.
getDimensionDataSourceType(dimension)	Obtiene el tipo de origen de datos de la serie de gráficos.
getDimensionValues(dimension)	Obtiene los valores de una sola dimensión de la serie de gráficos. Estos pueden ser valores de categoría o valores de datos, dependiendo de la dimensión especificada y de cómo se asignan los datos para la serie de gráficos.
getDoughnutHoleSize()	Representa el tamaño del agujero de los anillos de una serie de gráfico. Solo es válido en los gráficos de anillos y anillos explotados. Produce un `InvalidArgument` error en gráficos no válidos.
getExplosion()	Especifica el valor de explosión de un gráfico circular o un segmento de gráfico de anillos. Devuelve 0 (cero) si no hay expansión (el vértice del sector está en el centro del círculo).
getFiltered()	Especifica si la serie está filtrada. No aplicable para los gráficos de superficie.
getFirstSliceAngle()	Especifica el ángulo del primer gráfico circular o segmento de gráfico de anillos, en grados (en el sentido de las agujas del reloj desde vertical). Se aplica solo a gráficos circulares, circulares 3D y de anillos. Puede ser un valor comprendido entre 0 y 360.
getFormat()	Representa el formato de una serie del gráfico, que incluye el formato de relleno y de línea.
getGapWidth()	Representa el ancho del rango de una serie de gráfico. Solo es válido en gráficos de barras y columnas, así como clases específicas de gráficos circulares y de líneas. Produce una excepción de argumento no válida en gráficos no válidos.
getGradientMaximumColor()	Especifica el color del valor máximo de una serie de gráficos de mapa de regiones.
getGradientMaximumType()	Especifica el tipo para el valor máximo de una serie de gráficos de mapa de regiones.
getGradientMaximumValue()	Especifica el valor máximo de una serie de gráficos de mapa de regiones.
getGradientMidpointColor()	Especifica el color del valor de punto medio de una serie de gráficos de mapa de regiones.
getGradientMidpointType()	Especifica el tipo para el valor de punto medio de una serie de gráficos de mapa de regiones.
getGradientMidpointValue()	Especifica el valor de punto medio de una serie de gráficos de mapa de regiones.
getGradientMinimumColor()	Especifica el color del valor mínimo de una serie de gráficos de mapa de regiones.
getGradientMinimumType()	Especifica el tipo para el valor mínimo de una serie de gráficos de mapa de regiones.
getGradientMinimumValue()	Especifica el valor mínimo de una serie de gráficos de mapa de regiones.
getGradientStyle()	Especifica el estilo de degradado de serie de un gráfico de mapa de regiones.
getHasDataLabels()	Especifica si la serie tiene etiquetas de datos.
getInvertColor()	Especifica el color de relleno de los puntos de datos negativos de una serie.
getInvertIfNegative()	True si Excel invierte el patrón en el elemento cuando corresponde a un número negativo.
getMapOptions()	Contiene las opciones para un gráfico de mapa de región.
getMarkerBackgroundColor()	Especifica el color de fondo del marcador de una serie de gráficos.
getMarkerForegroundColor()	Especifica el color de primer plano del marcador de una serie de gráficos.
getMarkerSize()	Especifica el tamaño del marcador de una serie de gráficos. El intervalo de tamaño admitido es de 2 a 72. Este método devuelve un error InvalidArgument si se establece con un tamaño fuera del intervalo admitido.
getMarkerStyle()	Especifica el estilo de marcador de una serie de gráficos. Vea `ExcelScript.ChartMarkerStyle` para más información.
getName()	Especifica el nombre de una serie en un gráfico. La longitud del nombre no debe tener más de 255 caracteres.
getOverlap()	Especifica cómo se colocan las barras y columnas. Puede ser un valor comprendido entre -100 y 100. Se aplica solo a los gráficos 2D de barras y columnas.
getParentLabelStrategy()	Especifica el área de estrategia de etiqueta primaria de la serie para un gráfico de gráficos de rectángulos.
getPlotOrder()	Especifica el orden de trazado de una serie de gráficos dentro del grupo de gráficos.
getPoints()	Devuelve una colección de todos los puntos de la serie.
getSecondPlotSize()	Especifica el tamaño de la sección secundaria de un gráfico circular o un gráfico de barras circulares, como un porcentaje del tamaño del gráfico circular principal. Puede ser un valor comprendido entre 5 y 200.
getShowConnectorLines()	Especifica si las líneas del conector se muestran en gráficos en cascada.
getShowLeaderLines()	Especifica si se muestran líneas de directriz para cada etiqueta de datos de la serie.
getShowShadow()	Especifica si la serie tiene una sombra.
getSmooth()	Especifica si la serie es suave. Solo se aplica a gráficos de líneas y dispersión.
getSplitType()	Especifica la forma en que se dividen las dos secciones de un gráfico circular de pie o de una barra de gráfico circular.
getSplitValue()	Especifica el valor de umbral que separa dos secciones de un gráfico circular de gráfico circular o un gráfico de barras circulares.
getTrendlines()	Colección de líneas de tendencia de la serie.
getVaryByCategories()	True si Excel asigna un color o patrón diferente a cada marcador de datos. El gráfico debe contener una sola serie.
getXErrorBars()	Indica el objeto de la barra de error de una serie de gráficos.
getYErrorBars()	Indica el objeto de la barra de error de una serie de gráficos.
setAxisGroup(axisGroup)	Especifica el grupo de la serie especificada.
setBubbleScale(bubbleScale)	Esto puede ser un valor entero entre 0 (cero) y 300, que representa el porcentaje del tamaño predeterminado. Esta propiedad solo se aplica a los gráficos de burbujas.
setBubbleSizes(sourceData)	Establece los tamaños de burbuja de una serie de gráficos. Solo funciona para los gráficos de burbujas.
setChartType(chartType)	Representa el tipo de gráfico de una serie. Vea `ExcelScript.ChartType` para más información.
setDoughnutHoleSize(doughnutHoleSize)	Representa el tamaño del agujero de los anillos de una serie de gráfico. Solo es válido en los gráficos de anillos y anillos explotados. Produce un `InvalidArgument` error en gráficos no válidos.
setExplosion(explosion)	Especifica el valor de explosión de un gráfico circular o un segmento de gráfico de anillos. Devuelve 0 (cero) si no hay expansión (el vértice del sector está en el centro del círculo).
setFiltered(filtered)	Especifica si la serie está filtrada. No aplicable para los gráficos de superficie.
setFirstSliceAngle(firstSliceAngle)	Especifica el ángulo del primer gráfico circular o segmento de gráfico de anillos, en grados (en el sentido de las agujas del reloj desde vertical). Se aplica solo a gráficos circulares, circulares 3D y de anillos. Puede ser un valor comprendido entre 0 y 360.
setGapWidth(gapWidth)	Representa el ancho del rango de una serie de gráfico. Solo es válido en gráficos de barras y columnas, así como clases específicas de gráficos circulares y de líneas. Produce una excepción de argumento no válida en gráficos no válidos.
setGradientMaximumColor(gradientMaximumColor)	Especifica el color del valor máximo de una serie de gráficos de mapa de regiones.
setGradientMaximumType(gradientMaximumType)	Especifica el tipo para el valor máximo de una serie de gráficos de mapa de regiones.
setGradientMaximumValue(gradientMaximumValue)	Especifica el valor máximo de una serie de gráficos de mapa de regiones.
setGradientMidpointColor(gradientMidpointColor)	Especifica el color del valor de punto medio de una serie de gráficos de mapa de regiones.
setGradientMidpointType(gradientMidpointType)	Especifica el tipo para el valor de punto medio de una serie de gráficos de mapa de regiones.
setGradientMidpointValue(gradientMidpointValue)	Especifica el valor de punto medio de una serie de gráficos de mapa de regiones.
setGradientMinimumColor(gradientMinimumColor)	Especifica el color del valor mínimo de una serie de gráficos de mapa de regiones.
setGradientMinimumType(gradientMinimumType)	Especifica el tipo para el valor mínimo de una serie de gráficos de mapa de regiones.
setGradientMinimumValue(gradientMinimumValue)	Especifica el valor mínimo de una serie de gráficos de mapa de regiones.
setGradientStyle(gradientStyle)	Especifica el estilo de degradado de serie de un gráfico de mapa de regiones.
setHasDataLabels(hasDataLabels)	Especifica si la serie tiene etiquetas de datos.
setInvertColor(invertColor)	Especifica el color de relleno de los puntos de datos negativos de una serie.
setInvertIfNegative(invertIfNegative)	True si Excel invierte el patrón en el elemento cuando corresponde a un número negativo.
setMarkerBackgroundColor(markerBackgroundColor)	Especifica el color de fondo del marcador de una serie de gráficos.
setMarkerForegroundColor(markerForegroundColor)	Especifica el color de primer plano del marcador de una serie de gráficos.
setMarkerSize(markerSize)	Especifica el tamaño del marcador de una serie de gráficos. El intervalo de tamaño admitido es de 2 a 72. Este método devuelve un error InvalidArgument si se establece con un tamaño fuera del intervalo admitido.
setMarkerStyle(markerStyle)	Especifica el estilo de marcador de una serie de gráficos. Vea `ExcelScript.ChartMarkerStyle` para más información.
setName(name)	Especifica el nombre de una serie en un gráfico. La longitud del nombre no debe tener más de 255 caracteres.
setOverlap(overlap)	Especifica cómo se colocan las barras y columnas. Puede ser un valor comprendido entre -100 y 100. Se aplica solo a los gráficos 2D de barras y columnas.
setParentLabelStrategy(parentLabelStrategy)	Especifica el área de estrategia de etiqueta primaria de la serie para un gráfico de gráficos de rectángulos.
setPlotOrder(plotOrder)	Especifica el orden de trazado de una serie de gráficos dentro del grupo de gráficos.
setSecondPlotSize(secondPlotSize)	Especifica el tamaño de la sección secundaria de un gráfico circular o un gráfico de barras circulares, como un porcentaje del tamaño del gráfico circular principal. Puede ser un valor comprendido entre 5 y 200.
setShowConnectorLines(showConnectorLines)	Especifica si las líneas del conector se muestran en gráficos en cascada.
setShowLeaderLines(showLeaderLines)	Especifica si se muestran líneas de directriz para cada etiqueta de datos de la serie.
setShowShadow(showShadow)	Especifica si la serie tiene una sombra.
setSmooth(smooth)	Especifica si la serie es suave. Solo se aplica a gráficos de líneas y dispersión.
setSplitType(splitType)	Especifica la forma en que se dividen las dos secciones de un gráfico circular de pie o de una barra de gráfico circular.
setSplitValue(splitValue)	Especifica el valor de umbral que separa dos secciones de un gráfico circular de gráfico circular o un gráfico de barras circulares.
setValues(sourceData)	Establece los valores de una serie de gráficos. En el caso de los gráficos de dispersión, hace referencia a los valores del eje Y.
setVaryByCategories(varyByCategories)	True si Excel asigna un color o patrón diferente a cada marcador de datos. El gráfico debe contener una sola serie.
setXAxisValues(sourceData)	Establece los valores del eje X para una serie de gráficos.

Detalles del método

addChartTrendline(type)

Agrega una nueva línea de tendencia a la colección de líneas de tendencia.

addChartTrendline(type?: ChartTrendlineType): ChartTrendline;

Parámetros

type: ExcelScript.ChartTrendlineType

Especifica el tipo de línea de tendencia. El valor predeterminado es "Linear". Vea ExcelScript.ChartTrendline para más información.

Devoluciones

ExcelScript.ChartTrendline

delete()

Elimina la serie del gráfico.

delete(): void;

Devoluciones

void

getAxisGroup()

Especifica el grupo de la serie especificada.

getAxisGroup(): ChartAxisGroup;

Devoluciones

ExcelScript.ChartAxisGroup

getBinOptions()

Contiene las opciones de intervalo para gráficos de histograma y diagramas de Pareto.

getBinOptions(): ChartBinOptions;

Devoluciones

ExcelScript.ChartBinOptions

getBoxwhiskerOptions()

Contiene las opciones para el gráfico de cajas y bigotes.

getBoxwhiskerOptions(): ChartBoxwhiskerOptions;

Devoluciones

ExcelScript.ChartBoxwhiskerOptions

getBubbleScale()

Esto puede ser un valor entero entre 0 (cero) y 300, que representa el porcentaje del tamaño predeterminado. Esta propiedad solo se aplica a los gráficos de burbujas.

getBubbleScale(): number;

Devoluciones

number

getChartTrendline(index)

Obtiene un objeto de línea de tendencia por índice, que es el orden de inserción en la matriz de elementos.

getChartTrendline(index: number): ChartTrendline;

Parámetros

index: number

Representa el orden de inserción en la matriz de elementos.

Devoluciones

ExcelScript.ChartTrendline

getChartType()

Representa el tipo de gráfico de una serie. Vea ExcelScript.ChartType para más información.

getChartType(): ChartType;

Devoluciones

ExcelScript.ChartType

getDataLabels()

Representa una colección de todas las etiquetas de datos de la serie.

getDataLabels(): ChartDataLabels;

Devoluciones

ExcelScript.ChartDataLabels

getDimensionDataSourceString(dimension)

Obtiene la representación de cadena del origen de datos de la serie de gráficos. La representación de cadena podría ser información como una dirección de celda.

getDimensionDataSourceString(dimension: ChartSeriesDimension): string;

Parámetros

dimension: ExcelScript.ChartSeriesDimension

Dimensión del eje del que proceden los datos.

Devoluciones

string

getDimensionDataSourceType(dimension)

Obtiene el tipo de origen de datos de la serie de gráficos.

getDimensionDataSourceType(
            dimension: ChartSeriesDimension
        ): ChartDataSourceType;

Parámetros

dimension: ExcelScript.ChartSeriesDimension

Dimensión del eje del que proceden los datos.

Devoluciones

ExcelScript.ChartDataSourceType

getDimensionValues(dimension)

Obtiene los valores de una sola dimensión de la serie de gráficos. Estos pueden ser valores de categoría o valores de datos, dependiendo de la dimensión especificada y de cómo se asignan los datos para la serie de gráficos.

getDimensionValues(dimension: ChartSeriesDimension): string[];

Parámetros

dimension: ExcelScript.ChartSeriesDimension

Dimensión del eje del que proceden los datos.

Devoluciones

string[]

getDoughnutHoleSize()

Representa el tamaño del agujero de los anillos de una serie de gráfico. Solo es válido en los gráficos de anillos y anillos explotados. Produce un InvalidArgument error en gráficos no válidos.

getDoughnutHoleSize(): number;

Devoluciones

number

getExplosion()

Especifica el valor de explosión de un gráfico circular o un segmento de gráfico de anillos. Devuelve 0 (cero) si no hay expansión (el vértice del sector está en el centro del círculo).

getExplosion(): number;

Devoluciones

number

getFiltered()

Especifica si la serie está filtrada. No aplicable para los gráficos de superficie.

getFiltered(): boolean;

Devoluciones

boolean

getFirstSliceAngle()

Especifica el ángulo del primer gráfico circular o segmento de gráfico de anillos, en grados (en el sentido de las agujas del reloj desde vertical). Se aplica solo a gráficos circulares, circulares 3D y de anillos. Puede ser un valor comprendido entre 0 y 360.

getFirstSliceAngle(): number;

Devoluciones

number

getFormat()

Representa el formato de una serie del gráfico, que incluye el formato de relleno y de línea.

getFormat(): ChartSeriesFormat;

Devoluciones

ExcelScript.ChartSeriesFormat

getGapWidth()

Representa el ancho del rango de una serie de gráfico. Solo es válido en gráficos de barras y columnas, así como clases específicas de gráficos circulares y de líneas. Produce una excepción de argumento no válida en gráficos no válidos.

getGapWidth(): number;

Devoluciones

number

getGradientMaximumColor()

Especifica el color del valor máximo de una serie de gráficos de mapa de regiones.

getGradientMaximumColor(): string;

Devoluciones

string

getGradientMaximumType()

Especifica el tipo para el valor máximo de una serie de gráficos de mapa de regiones.

getGradientMaximumType(): ChartGradientStyleType;

Devoluciones

ExcelScript.ChartGradientStyleType

getGradientMaximumValue()

Especifica el valor máximo de una serie de gráficos de mapa de regiones.

getGradientMaximumValue(): number;

Devoluciones

number

getGradientMidpointColor()

Especifica el color del valor de punto medio de una serie de gráficos de mapa de regiones.

getGradientMidpointColor(): string;

Devoluciones

string

getGradientMidpointType()

Especifica el tipo para el valor de punto medio de una serie de gráficos de mapa de regiones.

getGradientMidpointType(): ChartGradientStyleType;

Devoluciones

ExcelScript.ChartGradientStyleType

getGradientMidpointValue()

Especifica el valor de punto medio de una serie de gráficos de mapa de regiones.

getGradientMidpointValue(): number;

Devoluciones

number

getGradientMinimumColor()

Especifica el color del valor mínimo de una serie de gráficos de mapa de regiones.

getGradientMinimumColor(): string;

Devoluciones

string

getGradientMinimumType()

Especifica el tipo para el valor mínimo de una serie de gráficos de mapa de regiones.

getGradientMinimumType(): ChartGradientStyleType;

Devoluciones

ExcelScript.ChartGradientStyleType

getGradientMinimumValue()

Especifica el valor mínimo de una serie de gráficos de mapa de regiones.

getGradientMinimumValue(): number;

Devoluciones

number

getGradientStyle()

Especifica el estilo de degradado de serie de un gráfico de mapa de regiones.

getGradientStyle(): ChartGradientStyle;

Devoluciones

ExcelScript.ChartGradientStyle

getHasDataLabels()

Especifica si la serie tiene etiquetas de datos.

getHasDataLabels(): boolean;

Devoluciones

boolean

getInvertColor()

Especifica el color de relleno de los puntos de datos negativos de una serie.

getInvertColor(): string;

Devoluciones

string

getInvertIfNegative()

True si Excel invierte el patrón en el elemento cuando corresponde a un número negativo.

getInvertIfNegative(): boolean;

Devoluciones

boolean

getMapOptions()

Contiene las opciones para un gráfico de mapa de región.

getMapOptions(): ChartMapOptions;

Devoluciones

ExcelScript.ChartMapOptions

getMarkerBackgroundColor()

Especifica el color de fondo del marcador de una serie de gráficos.

getMarkerBackgroundColor(): string;

Devoluciones

string

getMarkerForegroundColor()

Especifica el color de primer plano del marcador de una serie de gráficos.

getMarkerForegroundColor(): string;

Devoluciones

string

getMarkerSize()

Especifica el tamaño del marcador de una serie de gráficos. El intervalo de tamaño admitido es de 2 a 72. Este método devuelve un error InvalidArgument si se establece con un tamaño fuera del intervalo admitido.

getMarkerSize(): number;

Devoluciones

number

getMarkerStyle()

Especifica el estilo de marcador de una serie de gráficos. Vea ExcelScript.ChartMarkerStyle para más información.

getMarkerStyle(): ChartMarkerStyle;

Devoluciones

ExcelScript.ChartMarkerStyle

getName()

Especifica el nombre de una serie en un gráfico. La longitud del nombre no debe tener más de 255 caracteres.

getName(): string;

Devoluciones

string

Ejemplos

/**
 * This sample logs the names of each of the chart series in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Log the name of each chart series in the chart.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    console.log(series.getName());
  });
}

getOverlap()

Especifica cómo se colocan las barras y columnas. Puede ser un valor comprendido entre -100 y 100. Se aplica solo a los gráficos 2D de barras y columnas.

getOverlap(): number;

Devoluciones

number

getParentLabelStrategy()

Especifica el área de estrategia de etiqueta primaria de la serie para un gráfico de gráficos de rectángulos.

getParentLabelStrategy(): ChartParentLabelStrategy;

Devoluciones

ExcelScript.ChartParentLabelStrategy

getPlotOrder()

Especifica el orden de trazado de una serie de gráficos dentro del grupo de gráficos.

getPlotOrder(): number;

Devoluciones

number

getPoints()

Devuelve una colección de todos los puntos de la serie.

getPoints(): ChartPoint[];

Devoluciones

ExcelScript.ChartPoint[]

getSecondPlotSize()

Especifica el tamaño de la sección secundaria de un gráfico circular o un gráfico de barras circulares, como un porcentaje del tamaño del gráfico circular principal. Puede ser un valor comprendido entre 5 y 200.

getSecondPlotSize(): number;

Devoluciones

number

getShowConnectorLines()

Especifica si las líneas del conector se muestran en gráficos en cascada.

getShowConnectorLines(): boolean;

Devoluciones

boolean

getShowLeaderLines()

Especifica si se muestran líneas de directriz para cada etiqueta de datos de la serie.

getShowLeaderLines(): boolean;

Devoluciones

boolean

getShowShadow()

Especifica si la serie tiene una sombra.

getShowShadow(): boolean;

Devoluciones

boolean

getSmooth()

Especifica si la serie es suave. Solo se aplica a gráficos de líneas y dispersión.

getSmooth(): boolean;

Devoluciones

boolean

getSplitType()

Especifica la forma en que se dividen las dos secciones de un gráfico circular de pie o de una barra de gráfico circular.

getSplitType(): ChartSplitType;

Devoluciones

ExcelScript.ChartSplitType

getSplitValue()

Especifica el valor de umbral que separa dos secciones de un gráfico circular de gráfico circular o un gráfico de barras circulares.

getSplitValue(): number;

Devoluciones

number

getTrendlines()

Colección de líneas de tendencia de la serie.

getTrendlines(): ChartTrendline[];

Devoluciones

ExcelScript.ChartTrendline[]

getVaryByCategories()

True si Excel asigna un color o patrón diferente a cada marcador de datos. El gráfico debe contener una sola serie.

getVaryByCategories(): boolean;

Devoluciones

boolean

getXErrorBars()

Indica el objeto de la barra de error de una serie de gráficos.

getXErrorBars(): ChartErrorBars;

Devoluciones

ExcelScript.ChartErrorBars

getYErrorBars()

Indica el objeto de la barra de error de una serie de gráficos.

getYErrorBars(): ChartErrorBars;

Devoluciones

ExcelScript.ChartErrorBars

Ejemplos

/**
 * This script adds error bars for the standard error of each chart series point.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range for the chart.
  const worksheet = workbook.getWorksheet("Sample");
  const dataRange = worksheet.getRange("A1:B15");

  // Create a line chart.
  const chart = worksheet.addChart(ExcelScript.ChartType.line, dataRange);

  // For each series, add error bars for the standard error on each point
  const allSeries = chart.getSeries();
  allSeries.forEach((series) => {
    series.getYErrorBars().setType(ExcelScript.ChartErrorBarsType.stError);
    series.getYErrorBars().setVisible(true);
  });
}

setAxisGroup(axisGroup)

Especifica el grupo de la serie especificada.

setAxisGroup(axisGroup: ChartAxisGroup): void;

Parámetros

axisGroup: ExcelScript.ChartAxisGroup

Devoluciones

void

setBubbleScale(bubbleScale)

Esto puede ser un valor entero entre 0 (cero) y 300, que representa el porcentaje del tamaño predeterminado. Esta propiedad solo se aplica a los gráficos de burbujas.

setBubbleScale(bubbleScale: number): void;

Parámetros

bubbleScale: number

Devoluciones

void

setBubbleSizes(sourceData)

Establece los tamaños de burbuja de una serie de gráficos. Solo funciona para los gráficos de burbujas.

setBubbleSizes(sourceData: Range): void;

Parámetros

sourceData: ExcelScript.Range

Objeto Range correspondiente a los datos de origen.

Devoluciones

void

setChartType(chartType)

Representa el tipo de gráfico de una serie. Vea ExcelScript.ChartType para más información.

setChartType(chartType: ChartType): void;

Parámetros

chartType: ExcelScript.ChartType

Devoluciones

void

setDoughnutHoleSize(doughnutHoleSize)

setDoughnutHoleSize(doughnutHoleSize: number): void;

Parámetros

doughnutHoleSize: number

Devoluciones

void

setExplosion(explosion)

Especifica el valor de explosión de un gráfico circular o un segmento de gráfico de anillos. Devuelve 0 (cero) si no hay expansión (el vértice del sector está en el centro del círculo).

setExplosion(explosion: number): void;

Parámetros

explosion: number

Devoluciones

void

setFiltered(filtered)

Especifica si la serie está filtrada. No aplicable para los gráficos de superficie.

setFiltered(filtered: boolean): void;

Parámetros

filtered: boolean

Devoluciones

void

setFirstSliceAngle(firstSliceAngle)

setFirstSliceAngle(firstSliceAngle: number): void;

Parámetros

firstSliceAngle: number

Devoluciones

void

setGapWidth(gapWidth)

setGapWidth(gapWidth: number): void;

Parámetros

gapWidth: number

Devoluciones

void

setGradientMaximumColor(gradientMaximumColor)

Especifica el color del valor máximo de una serie de gráficos de mapa de regiones.

setGradientMaximumColor(gradientMaximumColor: string): void;

Parámetros

gradientMaximumColor: string

Devoluciones

void

setGradientMaximumType(gradientMaximumType)

Especifica el tipo para el valor máximo de una serie de gráficos de mapa de regiones.

setGradientMaximumType(
            gradientMaximumType: ChartGradientStyleType
        ): void;

Parámetros

gradientMaximumType: ExcelScript.ChartGradientStyleType

Devoluciones

void

setGradientMaximumValue(gradientMaximumValue)

Especifica el valor máximo de una serie de gráficos de mapa de regiones.

setGradientMaximumValue(gradientMaximumValue: number): void;

Parámetros

gradientMaximumValue: number

Devoluciones

void

setGradientMidpointColor(gradientMidpointColor)

Especifica el color del valor de punto medio de una serie de gráficos de mapa de regiones.

setGradientMidpointColor(gradientMidpointColor: string): void;

Parámetros

gradientMidpointColor: string

Devoluciones

void

setGradientMidpointType(gradientMidpointType)

Especifica el tipo para el valor de punto medio de una serie de gráficos de mapa de regiones.

setGradientMidpointType(
            gradientMidpointType: ChartGradientStyleType
        ): void;

Parámetros

gradientMidpointType: ExcelScript.ChartGradientStyleType

Devoluciones

void

setGradientMidpointValue(gradientMidpointValue)

Especifica el valor de punto medio de una serie de gráficos de mapa de regiones.

setGradientMidpointValue(gradientMidpointValue: number): void;

Parámetros

gradientMidpointValue: number

Devoluciones

void

setGradientMinimumColor(gradientMinimumColor)

Especifica el color del valor mínimo de una serie de gráficos de mapa de regiones.

setGradientMinimumColor(gradientMinimumColor: string): void;

Parámetros

gradientMinimumColor: string

Devoluciones

void

setGradientMinimumType(gradientMinimumType)

Especifica el tipo para el valor mínimo de una serie de gráficos de mapa de regiones.

setGradientMinimumType(
            gradientMinimumType: ChartGradientStyleType
        ): void;

Parámetros

gradientMinimumType: ExcelScript.ChartGradientStyleType

Devoluciones

void

setGradientMinimumValue(gradientMinimumValue)

Especifica el valor mínimo de una serie de gráficos de mapa de regiones.

setGradientMinimumValue(gradientMinimumValue: number): void;

Parámetros

gradientMinimumValue: number

Devoluciones

void

setGradientStyle(gradientStyle)

Especifica el estilo de degradado de serie de un gráfico de mapa de regiones.

setGradientStyle(gradientStyle: ChartGradientStyle): void;

Parámetros

gradientStyle: ExcelScript.ChartGradientStyle

Devoluciones

void

setHasDataLabels(hasDataLabels)

Especifica si la serie tiene etiquetas de datos.

setHasDataLabels(hasDataLabels: boolean): void;

Parámetros

hasDataLabels: boolean

Devoluciones

void

setInvertColor(invertColor)

Especifica el color de relleno de los puntos de datos negativos de una serie.

setInvertColor(invertColor: string): void;

Parámetros

invertColor: string

Devoluciones

void

setInvertIfNegative(invertIfNegative)

True si Excel invierte el patrón en el elemento cuando corresponde a un número negativo.

setInvertIfNegative(invertIfNegative: boolean): void;

Parámetros

invertIfNegative: boolean

Devoluciones

void

setMarkerBackgroundColor(markerBackgroundColor)

Especifica el color de fondo del marcador de una serie de gráficos.

setMarkerBackgroundColor(markerBackgroundColor: string): void;

Parámetros

markerBackgroundColor: string

Devoluciones

void

setMarkerForegroundColor(markerForegroundColor)

Especifica el color de primer plano del marcador de una serie de gráficos.

setMarkerForegroundColor(markerForegroundColor: string): void;

Parámetros

markerForegroundColor: string

Devoluciones

void

setMarkerSize(markerSize)

setMarkerSize(markerSize: number): void;

Parámetros

markerSize: number

Devoluciones

void

setMarkerStyle(markerStyle)

Especifica el estilo de marcador de una serie de gráficos. Vea ExcelScript.ChartMarkerStyle para más información.

setMarkerStyle(markerStyle: ChartMarkerStyle): void;

Parámetros

markerStyle: ExcelScript.ChartMarkerStyle

Devoluciones

void

setName(name)

Especifica el nombre de una serie en un gráfico. La longitud del nombre no debe tener más de 255 caracteres.

setName(name: string): void;

Parámetros

name: string

Devoluciones

void

setOverlap(overlap)

Especifica cómo se colocan las barras y columnas. Puede ser un valor comprendido entre -100 y 100. Se aplica solo a los gráficos 2D de barras y columnas.

setOverlap(overlap: number): void;

Parámetros

overlap: number

Devoluciones

void

Ejemplos

/**
 * This sample sets the overlap of the columns in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Set the overlap of every column of each series within a category.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    // An overlap of 25 means the columns have 25% of their length overlapping with the adjacent columns in the same category.
    series.setOverlap(25);
  });
}

setParentLabelStrategy(parentLabelStrategy)

Especifica el área de estrategia de etiqueta primaria de la serie para un gráfico de gráficos de rectángulos.

setParentLabelStrategy(
            parentLabelStrategy: ChartParentLabelStrategy
        ): void;

Parámetros

parentLabelStrategy: ExcelScript.ChartParentLabelStrategy

Devoluciones

void

setPlotOrder(plotOrder)

Especifica el orden de trazado de una serie de gráficos dentro del grupo de gráficos.

setPlotOrder(plotOrder: number): void;

Parámetros

plotOrder: number

Devoluciones

void

setSecondPlotSize(secondPlotSize)

setSecondPlotSize(secondPlotSize: number): void;

Parámetros

secondPlotSize: number

Devoluciones

void

setShowConnectorLines(showConnectorLines)

Especifica si las líneas del conector se muestran en gráficos en cascada.

setShowConnectorLines(showConnectorLines: boolean): void;

Parámetros

showConnectorLines: boolean

Devoluciones

void

setShowLeaderLines(showLeaderLines)

Especifica si se muestran líneas de directriz para cada etiqueta de datos de la serie.

setShowLeaderLines(showLeaderLines: boolean): void;

Parámetros

showLeaderLines: boolean

Devoluciones

void

setShowShadow(showShadow)

Especifica si la serie tiene una sombra.

setShowShadow(showShadow: boolean): void;

Parámetros

showShadow: boolean

Devoluciones

void

setSmooth(smooth)

Especifica si la serie es suave. Solo se aplica a gráficos de líneas y dispersión.

setSmooth(smooth: boolean): void;

Parámetros

smooth: boolean

Devoluciones

void

setSplitType(splitType)

Especifica la forma en que se dividen las dos secciones de un gráfico circular de pie o de una barra de gráfico circular.

setSplitType(splitType: ChartSplitType): void;

Parámetros

splitType: ExcelScript.ChartSplitType

Devoluciones

void

setSplitValue(splitValue)

Especifica el valor de umbral que separa dos secciones de un gráfico circular de gráfico circular o un gráfico de barras circulares.

setSplitValue(splitValue: number): void;

Parámetros

splitValue: number

Devoluciones

void

setValues(sourceData)

Establece los valores de una serie de gráficos. En el caso de los gráficos de dispersión, hace referencia a los valores del eje Y.

setValues(sourceData: Range): void;

Parámetros

sourceData: ExcelScript.Range

Objeto Range correspondiente a los datos de origen.

Devoluciones

void

setVaryByCategories(varyByCategories)

True si Excel asigna un color o patrón diferente a cada marcador de datos. El gráfico debe contener una sola serie.

setVaryByCategories(varyByCategories: boolean): void;

Parámetros

varyByCategories: boolean

Devoluciones

void

setXAxisValues(sourceData)

Establece los valores del eje X para una serie de gráficos.

setXAxisValues(sourceData: Range): void;

Parámetros

sourceData: ExcelScript.Range

Objeto Range correspondiente a los datos de origen.

Devoluciones

void

Compartir a través de

ExcelScript.ChartSeries interface

Comentarios

Ejemplos

Métodos

Detalles del método

addChartTrendline(type)

Parámetros

Devoluciones

delete()

Devoluciones

getAxisGroup()

Devoluciones

getBinOptions()

Devoluciones

getBoxwhiskerOptions()

Devoluciones

getBubbleScale()

Devoluciones

getChartTrendline(index)

Parámetros

Devoluciones

getChartType()

Devoluciones

getDataLabels()

Devoluciones

getDimensionDataSourceString(dimension)

Parámetros

Devoluciones

getDimensionDataSourceType(dimension)

Parámetros

Devoluciones

getDimensionValues(dimension)

Parámetros

Devoluciones

getDoughnutHoleSize()

Devoluciones

getExplosion()

Devoluciones

getFiltered()

Devoluciones

getFirstSliceAngle()

Devoluciones

getFormat()

Devoluciones

getGapWidth()

Devoluciones

getGradientMaximumColor()

Devoluciones

getGradientMaximumType()

Devoluciones

getGradientMaximumValue()

Devoluciones

getGradientMidpointColor()

Devoluciones

getGradientMidpointType()

Devoluciones

getGradientMidpointValue()

Devoluciones

getGradientMinimumColor()

Devoluciones

getGradientMinimumType()

Devoluciones

getGradientMinimumValue()

Devoluciones

getGradientStyle()

Devoluciones

getHasDataLabels()

Devoluciones

getInvertColor()

Devoluciones

getInvertIfNegative()

Devoluciones

getMapOptions()

Devoluciones

getMarkerBackgroundColor()

Devoluciones

getMarkerForegroundColor()

Devoluciones

getMarkerSize()