Class EmbeddedPieChartBuilder

EmbeddedPieChartBuilder

Es un compilador para gráficos circulares. Para obtener más detalles, consulta la documentación.

Métodos

MétodoTipo de datos que se muestraDescripción breve
addRange(range)EmbeddedChartBuilderAgrega un rango al gráfico que modifica este compilador.
asAreaChart()EmbeddedAreaChartBuilderEstablece el tipo de gráfico como AreaChart y muestra un EmbeddedAreaChartBuilder.
asBarChart()EmbeddedBarChartBuilderEstablece el tipo de gráfico en BarChart y muestra un EmbeddedBarChartBuilder.
asColumnChart()EmbeddedColumnChartBuilderEstablece el tipo de gráfico en ColumnChart y muestra un EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderEstablece el tipo de gráfico en ComboChart y muestra un EmbeddedComboChartBuilder.
asHistogramChart()EmbeddedHistogramChartBuilderEstablece el tipo de gráfico en HistogramChart y muestra un EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderEstablece el tipo de gráfico en LineChart y muestra un EmbeddedLineChartBuilder.
asPieChart()EmbeddedPieChartBuilderEstablece el tipo de gráfico como PieChart y muestra un EmbeddedPieChartBuilder.
asScatterChart()EmbeddedScatterChartBuilderEstablece el tipo de gráfico en ScatterChart y muestra un EmbeddedScatterChartBuilder.
asTableChart()EmbeddedTableChartBuilderEstablece el tipo de gráfico como TableChart y muestra un EmbeddedTableChartBuilder.
build()EmbeddedChartCrea el gráfico para reflejar todos los cambios realizados en él.
clearRanges()EmbeddedChartBuilderQuita todos los rangos del gráfico que modifica este compilador.
getChartType()ChartTypeMuestra el tipo de gráfico actual.
getContainer()ContainerInfoMuestra el gráfico ContainerInfo, que encapsula el lugar en el que aparece el gráfico en la de la hoja de cálculo.
getRanges()Range[]Muestra una copia de la lista de rangos que actualmente proporcionan datos para este gráfico.
removeRange(range)EmbeddedChartBuilderQuita el rango especificado del gráfico que modifica este compilador.
reverseCategories()EmbeddedPieChartBuilderInvierte el dibujo de series en el eje de dominio.
set3D()EmbeddedPieChartBuilderEstablece que el gráfico es tridimensional.
setBackgroundColor(cssValue)EmbeddedPieChartBuilderEstablece el color de fondo del gráfico.
setChartType(type)EmbeddedChartBuilderCambia el tipo de gráfico.
setColors(cssValues)EmbeddedPieChartBuilderEstablece los colores de las líneas del gráfico.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderEstablece la estrategia que se usará para las filas y columnas ocultas.
setLegendPosition(position)EmbeddedPieChartBuilderEstablece la posición de la leyenda con respecto al gráfico.
setLegendTextStyle(textStyle)EmbeddedPieChartBuilderEstablece el estilo de texto de la leyenda del gráfico.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderEstablece la estrategia de combinación que se debe utilizar cuando existe más de un rango.
setNumHeaders(headers)EmbeddedChartBuilderEstablece el número de filas o columnas del rango que deben tratarse como encabezados.
setOption(option, value)EmbeddedChartBuilderEstablece las opciones avanzadas para este gráfico.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderEstablece la posición y cambia el lugar en el que aparece el gráfico en la hoja.
setTitle(chartTitle)EmbeddedPieChartBuilderEstablece el título del gráfico.
setTitleTextStyle(textStyle)EmbeddedPieChartBuilderEstablece el estilo de texto del título del gráfico.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderEstablece si se transponen las filas y columnas del gráfico.

Documentación detallada

addRange(range)

Agrega un rango al gráfico que modifica este compilador. No agrega el rango si ya se aplicó agregado al gráfico.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
rangeRangeEl rango que se agregará.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


asAreaChart()

Establece el tipo de gráfico como AreaChart y muestra un EmbeddedAreaChartBuilder.

Volver

EmbeddedAreaChartBuilder: Es un compilador para un gráfico de áreas.


asBarChart()

Establece el tipo de gráfico en BarChart y muestra un EmbeddedBarChartBuilder.

Volver

EmbeddedBarChartBuilder: Es un compilador para un gráfico de barras.


asColumnChart()

Establece el tipo de gráfico en ColumnChart y muestra un EmbeddedColumnChartBuilder.

Volver

EmbeddedColumnChartBuilder: Es un compilador para un gráfico de columnas.


asComboChart()

Establece el tipo de gráfico en ComboChart y muestra un EmbeddedComboChartBuilder.

Volver

EmbeddedComboChartBuilder: Es un compilador para un gráfico combinado.


asHistogramChart()

Establece el tipo de gráfico en HistogramChart y muestra un EmbeddedHistogramChartBuilder.

Volver

EmbeddedHistogramChartBuilder: Es un compilador para un gráfico de histograma.


asLineChart()

Establece el tipo de gráfico en LineChart y muestra un EmbeddedLineChartBuilder.

Volver

EmbeddedLineChartBuilder: Es un compilador para un gráfico de líneas.


asPieChart()

Establece el tipo de gráfico como PieChart y muestra un EmbeddedPieChartBuilder.

Volver

EmbeddedPieChartBuilder: Es un compilador para un gráfico circular.


asScatterChart()

Establece el tipo de gráfico en ScatterChart y muestra un EmbeddedScatterChartBuilder.

Volver

EmbeddedScatterChartBuilder: Es un compilador para un diagrama de dispersión.


asTableChart()

Establece el tipo de gráfico como TableChart y muestra un EmbeddedTableChartBuilder.

Volver

EmbeddedTableChartBuilder: Es un compilador para un gráfico de tablas.


build()

Crea el gráfico para reflejar todos los cambios realizados en él.

Este método no dibuja automáticamente el gráfico en la parte superior de la hoja de cálculo. Un gráfico nuevo debe insertarse a través de sheet.insertChart(chart) y se debe actualizar un gráfico existente a través de sheet.updateChart(chart).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Volver

EmbeddedChart: Es el gráfico creado, que aún debe agregarse a la hoja de cálculo.


clearRanges()

Quita todos los rangos del gráfico que modifica este compilador.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


getChartType()

Muestra el tipo de gráfico actual.

Volver

ChartType: Es el tipo de gráfico.


getContainer()

Muestra el gráfico ContainerInfo, que encapsula el lugar en el que aparece el gráfico en la de la hoja de cálculo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

Volver

ContainerInfo: Es un objeto que contiene la posición del contenedor del gráfico.


getRanges()

Muestra una copia de la lista de rangos que actualmente proporcionan datos para este gráfico. Usa addRange(range) y removeRange(range) para modificar esta lista.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

Volver

Range[]: Es un array de rangos que funcionan como la fuente de datos de la compilación del gráfico.


removeRange(range)

Quita el rango especificado del gráfico que modifica este compilador. No arroja un error si el rango no está en este gráfico.

El rango que se quite debe coincidir con un rango agregado a través de addRange(range). de lo contrario, no se realizará ningún cambio en el gráfico. No se puede usar este método para quitar valores de forma parcial de un rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(firstRange)
    // This range will render in a different color
    .addRange(secondRange)
    .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
rangeRangeEl rango que se quitará.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


reverseCategories()

Invierte el dibujo de series en el eje de dominio. Para los gráficos de rango vertical (como líneas, gráficos de áreas o columnas), esto significa que el eje horizontal se dibuja de derecha a izquierda. Para los gráficos de rango horizontal (como los gráficos de barras); esto significa que el eje vertical se dibuja desde arriba hacia abajo. En el caso de los gráficos circulares, esto significa que las porciones se dibujan en sentido antihorario.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


set3D()

Establece que el gráfico sea tridimensional.

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setBackgroundColor(cssValue)

Establece el color de fondo del gráfico.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parámetros

NombreTipoDescripción
cssValueStringEs el valor de CSS para el color (como "blue" o "#00f").

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setChartType(type)

Cambia el tipo de gráfico. Por el momento, no se admiten todos los tipos de gráficos incorporados. Consulta los ChartType.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
typeChartTypeEl tipo al que se cambiará este gráfico.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


setColors(cssValues)

Establece los colores de las líneas del gráfico.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parámetros

NombreTipoDescripción
cssValuesString[]Es un array de valores de CSS de color, como ["red", "#acf"]. El enésimo elemento del array representa el color de la enésima línea del gráfico.

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setHiddenDimensionStrategy(strategy)

Establece la estrategia que se usará para las filas y columnas ocultas. La configuración predeterminada es IGNORE_ROWS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
strategyChartHiddenDimensionStrategyLa estrategia que se usará para las filas y columnas ocultas.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


setLegendPosition(position)

Establece la posición de la leyenda con respecto al gráfico. De forma predeterminada, no hay una leyenda.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parámetros

NombreTipoDescripción
positionPositionLa posición de la leyenda.

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setLegendTextStyle(textStyle)

Establece el estilo de texto de la leyenda del gráfico.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parámetros

NombreTipoDescripción
textStyleTextStyleEl estilo de texto que se usará para la leyenda del gráfico.

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setMergeStrategy(mergeStrategy)

Establece la estrategia de combinación que se debe utilizar cuando existe más de un rango. Si es MERGE_ROWS, las filas se combinan; si es MERGE_COLUMNS, las columnas se combinan. La configuración predeterminada es MERGE_COLUMNS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
mergeStrategyChartMergeStrategyEstrategia de combinación a usar.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


setNumHeaders(headers)

Establece el número de filas o columnas del rango que deben tratarse como encabezados.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
headersIntegerLa cantidad de filas o columnas que se deben tratar como encabezados. Los valores negativos generan encabezados se detecten automáticamente.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


setOption(option, value)

Establece las opciones avanzadas para este gráfico. Para ver una lista de las opciones disponibles, consulta Gráfico opciones de configuración.

Este método no valida que la opción que especifiques sea válida para este tipo de gráfico ni si sea del formato o la estructura correctos.

En este ejemplo, se muestra cómo cambiar el título y configurar una leyenda.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Parámetros

NombreTipoDescripción
optionStringEl nombre de la opción.
valueObjectEl valor de la opción.

Volver

EmbeddedChartBuilder: Este compilador, para encadenamiento,


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Establece la posición y cambia el lugar en el que aparece el gráfico en la hoja. anchorRowPos y anchorColPos tienen el índice 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
anchorRowPosIntegerEl lado superior del gráfico está anclado en esta fila.
anchorColPosIntegerEl lado izquierdo del gráfico está anclado en esta columna.
offsetXIntegerLa esquina superior derecha del gráfico está desplazada por esta cantidad de píxeles.
offsetYIntegerLa esquina inferior izquierda del gráfico está desplazada esta cantidad de píxeles.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.


setTitle(chartTitle)

Establece el título del gráfico. El título se muestra centrado encima del gráfico.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parámetros

NombreTipoDescripción
chartTitleStringel título del gráfico.

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setTitleTextStyle(textStyle)

Establece el estilo de texto del título del gráfico.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parámetros

NombreTipoDescripción
textStyleTextStyleEl estilo de texto que se utilizará para el título del gráfico. Puedes crear un objeto TextStyleBuilder llamando a Charts.newTextStyle().

Volver

EmbeddedPieChartBuilder: Este compilador es útil para el encadenamiento.


setTransposeRowsAndColumns(transpose)

Establece si se transponen las filas y columnas del gráfico. Si se configuran como true, las filas y se cambien las columnas. La configuración predeterminada es false.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parámetros

NombreTipoDescripción
transposeBooleanSi es true, las filas y columnas usadas para construir el gráfico se transpuesto.

Volver

EmbeddedChartBuilder: Este compilador se usa para encadenamiento.