Class EmbeddedLineChartBuilder

Aggiunge un intervallo al grafico modificato da questo generatore. Non aggiunge l'intervallo se è già stato aggiunte al grafico.

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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta il tipo di grafico su AreaChart e restituisce un EmbeddedAreaChartBuilder.

Invio

EmbeddedAreaChartBuilder: uno strumento per la creazione di un grafico ad area

Imposta il tipo di grafico su Grafico a barre e restituisce un EmbeddedBarChartBuilder.

Invio

EmbeddedBarChartBuilder: uno strumento per la creazione di un grafico a barre

Imposta il tipo di grafico su ColumnChart e restituisce un EmbeddedColumnChartBuilder.

Invio

EmbeddedColumnChartBuilder: uno strumento per la creazione di grafici a colonne

Imposta il tipo di grafico su ComboChart e restituisce un EmbeddedComboChartBuilder.

Invio

EmbeddedComboChartBuilder: uno strumento di creazione per un grafico combinato

Imposta il tipo di grafico su IstogramChart e restituisce un EmbeddedHistogramChartBuilder.

Invio

EmbeddedHistogramChartBuilder: uno strumento per la creazione di un istogramma

Imposta il tipo di grafico su LineChart e restituisce un EmbeddedLineChartBuilder.

Invio

EmbeddedLineChartBuilder: uno strumento per la creazione di un grafico a linee

Imposta il tipo di grafico su Grafico a torta e restituisce un EmbeddedPieChartBuilder.

Invio

EmbeddedPieChartBuilder: uno strumento per la creazione di grafici a torta

Imposta il tipo di grafico su Grafico a dispersione e restituisce un EmbeddedScatterChartBuilder.

Invio

EmbeddedScatterChartBuilder: uno strumento per la creazione di un grafico a dispersione

Imposta il tipo di grafico su TableChart e restituisce un EmbeddedTableChartBuilder.

Invio

EmbeddedTableChartBuilder: uno strumento per la creazione di un grafico a tabella

Crea il grafico per riflettere tutte le modifiche apportate.

Questo metodo non disegna automaticamente il grafico nella parte superiore del foglio di lavoro. Un nuovo grafico deve essere inserito tramite sheet.insertChart(chart) e un grafico esistente deve essere aggiornato tramite 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);

Invio

EmbeddedChart: il grafico creato, che deve ancora essere aggiunto al foglio di lavoro

Rimuove tutti gli intervalli dal grafico modificato da questo builder.

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);

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Restituisce il tipo di grafico corrente.

Invio

ChartType: il tipo di grafico

Restituisce il grafico ContainerInfo, che racchiude il punto in cui appare il grafico in un foglio di calcolo.

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

Invio

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico

Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per il grafico. Usa addRange(range) e removeRange(range) per modificare questo elenco.

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());
}

Invio

Range[]: un array di intervalli che fungono da origine dati da creare per il grafico

Rimuove l'intervallo specificato dal grafico modificato da questo builder. Non restituisce un errore se l'intervallo non è presente in questo grafico.

L'intervallo rimosso deve corrispondere a un intervallo aggiunto tramite addRange(range). altrimenti non vengono apportate modifiche al grafico. Impossibile utilizzare questo metodo per rimuovere parzialmente i valori da un intervallo.

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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Inverte il disegno di una serie nell'asse del dominio. Per i grafici a intervallo verticale (come i grafici a linee, grafici ad area o a colonne), significa che l'asse orizzontale è tracciato da destra a sinistra. Per i grafici con intervallo orizzontale (come quelli a barre), ciò significa che l'asse verticale è tracciato dall'alto verso in basso. Per i grafici a torta, le sezioni vengono tracciate in senso antiorario.

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

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta il colore di sfondo per il grafico.

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

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Modifica il tipo di grafico. Non tutti i tipi di grafici incorporati sono attualmente supportati. Leggi i 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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta i colori delle linee nel grafico.

// 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"]);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile da utilizzare per le curve nel grafico. Vedi CurveStyle per la curva consentita stili.

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Vedi anche

• CurveStyle

Consente di impostare la strategia da utilizzare per le righe e le colonne nascoste. Il valore predefinito è 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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta la posizione della legenda rispetto al grafico. Per impostazione predefinita, non esiste una legenda.

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

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile del testo della legenda del grafico.

// 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);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta la strategia di unione da utilizzare quando è presente più di un intervallo. Se MERGE_ROWS, le righe vengono unite; Se MERGE_COLUMNS, le colonne vengono unite. Il valore predefinito è 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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta il numero di righe o colonne dell'intervallo che devono essere trattate come intestazioni.

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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, consulta la sezione Grafico opzioni di configurazione.

Questo metodo non convalida l'opzione specificata sia valida per questo tipo di grafico né se l'elemento siano nel formato/struttura corretto.

Questo esempio mostra come modificare il titolo e impostare una legenda.

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

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento.

Consente di impostare lo stile dei punti della linea. Per impostazione predefinita, i punti non hanno uno stile particolare e la linea sia visibile.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Vedi anche

• PointStyle

Imposta la posizione, modificando la posizione del grafico nel foglio. anchorRowPos e anchorColPos sono indicizzati con 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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta l'intervallo per il grafico.

Se alcuni punti dati non rientrano nell'intervallo, l'intervallo viene espanso per includere quei dati. punti.

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta il titolo del grafico. Il titolo viene visualizzato al centro del grafico.

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

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile del testo del titolo del grafico.

// 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);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta la trasposizione di righe e colonne del grafico. Se impostato su true, le righe e le vengono scambiate tra colonne. Il valore predefinito è 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);

Parametri

Invio

EmbeddedChartBuilder: questo builder, per il concatenamento

Imposta lo stile del testo per l'asse orizzontale.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Aggiunge un titolo all'asse orizzontale. Il titolo è centrato e appare sotto il valore dell'asse etichette.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile del testo del titolo dell'asse orizzontale.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile di testo dell'asse verticale.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Aggiunge un titolo all'asse verticale. Il titolo è centrato e appare a sinistra del valore etichette.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta lo stile di testo del titolo dell'asse verticale.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parametri

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.

Imposta l'asse dell'intervallo in una scala logaritmica (richiede che tutti i valori siano positivi). L'intervallo asse è l'asse verticale dei grafici verticali (ad esempio a linee, ad area o a colonne) e asse orizzontale per i grafici orizzontali (ad esempio a barre).

Invio

EmbeddedLineChartBuilder: questo builder, utile per il concatenamento.