Questa pagina è stata tradotta dall'API Cloud Translation.

Class EmbeddedChart

Rappresenta un grafico incorporato in un foglio di lavoro.

Questo esempio mostra come modificare un grafico esistente:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2:B8")
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

Questo esempio mostra come creare un nuovo grafico:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

Metodi

Metodo	Tipo restituito	Breve descrizione
`asDataSourceChart()`	`DataSourceChart`	Trasmette a un'istanza del grafico dell'origine dati, se il grafico è un grafico di origine dati, o `null` in caso contrario.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto sotto forma di blob.
`getChartId()`	`Integer`	Restituisce un identificatore stabile per il grafico univoco nel foglio di lavoro contenente il grafico oppure `null` se il grafico non è presente in un foglio di lavoro.
`getContainerInfo()`	`ContainerInfo`	Restituisce informazioni sulla posizione del grafico all'interno di un foglio.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Restituisce la strategia da utilizzare per la gestione di righe e colonne nascoste.
`getMergeStrategy()`	`ChartMergeStrategy`	Restituisce la strategia di unione utilizzata quando esiste più di un intervallo.
`getNumHeaders()`	`Integer`	Restituisce il numero di righe o colonne dell'intervallo che vengono trattati come intestazioni.
`getOptions()`	`ChartOptions`	Restituisce le opzioni per questo grafico, ad esempio altezza, colori e assi.
`getRanges()`	`Range[]`	Restituisce gli intervalli utilizzati da questo grafico come origine dati.
`getTransposeRowsAndColumns()`	`Boolean`	Se il valore è `true`, le righe e le colonne utilizzate per popolare il grafico vengono scambiate.
`modify()`	`EmbeddedChartBuilder`	Restituisce un valore `EmbeddedChartBuilder` che può essere utilizzato per modificare questo grafico.

Documentazione dettagliata

`asDataSourceChart()`

Trasmette a un'istanza del grafico dell'origine dati, se il grafico è un grafico di origine dati, o null in caso contrario.

Ritorni

DataSourceChart: grafico dell'origine dati.

`getAs(contentType)`

Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.

Parametri

Nome	Tipo	Descrizione
`contentType`	`String`	Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, `'application/pdf'` è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, è valido anche qualsiasi formato `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`.

Ritorni

Blob: i dati sotto forma di blob.

`getBlob()`

Restituisce i dati all'interno di questo oggetto sotto forma di blob.

Ritorni

Blob: i dati sotto forma di blob.

`getChartId()`

Restituisce un identificatore stabile per il grafico univoco nel foglio di lavoro contenente il grafico oppure null se il grafico non è presente in un foglio di lavoro.

Ritorni

Integer: un identificatore del grafico stabile.

`getContainerInfo()`

Restituisce informazioni sulla posizione del grafico all'interno di un foglio.

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

var containerInfo = chart.getContainerInfo();

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

Ritorni

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico

`getHiddenDimensionStrategy()`

Restituisce la strategia da utilizzare per la gestione di righe e 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()

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

Ritorni

ChartHiddenDimensionStrategy: strategia da utilizzare per righe e colonne nascoste.

`getMergeStrategy()`

Restituisce la strategia di unione utilizzata quando esiste più di un intervallo. Con MERGE_ROWS, le righe vengono unite; con 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("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

Ritorni

ChartMergeStrategy: MERGE_ROWS se le righe vengono unite in più intervalli; MERGE_COLUMNS se le colonne vengono unite in più intervalli

`getNumHeaders()`

Restituisce il numero di righe o colonne dell'intervallo che vengono trattati 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()

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

Ritorni

Integer: il numero di righe o colonne trattate come intestazioni. I valori negativi indicano che le intestazioni vengono rilevate automaticamente.

`getOptions()`

Restituisce le opzioni per questo grafico, ad esempio altezza, colori e assi.

Le opzioni restituite sono immutabili.

Ritorni

ChartOptions: le opzioni di questo grafico, ad esempio altezza, colori e assi.

`getRanges()`

Restituisce gli intervalli utilizzati da questo grafico come origine dati.

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

var ranges = chart.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());
}

Ritorni

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

`getTransposeRowsAndColumns()`

Se il valore è true, le righe e le colonne utilizzate per popolare il grafico vengono scambiate. Il valore predefinito è false.

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

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

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

Ritorni

Boolean: true se le righe e le colonne utilizzate per creare il grafico sono trasposte.

`modify()`

Restituisce un valore EmbeddedChartBuilder che può essere utilizzato per modificare questo grafico. Richiama sheet.updateChart(chart) per salvare le modifiche.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

Ritorni

EmbeddedChartBuilder: uno strumento per la creazione di grafici incorporati