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:

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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`	Esegue il casting in un'istanza di grafico dell'origine dati se il grafico è un grafico dell'origine dati o `null` in caso contrario.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
`getBlob()`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob.
`getChartId()`	`Integer`	Restituisce un identificatore stabile per il grafico che è univoco nel foglio di lavoro contenente il grafico o `null` se il grafico non è 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 gestire le righe e le 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 trattate 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 `true`, le righe e le colonne utilizzate per compilare il grafico vengono scambiate.
`modify()`	`EmbeddedChartBuilder`	Restituisce un `EmbeddedChartBuilder` che può essere utilizzato per modificare questo grafico.

Documentazione dettagliata

`asDataSourceChart()`

Esegue il casting in un'istanza di grafico dell'origine dati se il grafico è un grafico dell'origine dati o null in caso contrario.

Invio

DataSourceChart: il grafico dell'origine dati.

`getAs(contentType)`

Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, assume che la parte del nome 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 a 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, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Per un documento di Documenti Google, è valido anche `'text/markdown'`.

Invio

Blob: i dati come blob.

`getBlob()`

Restituisce i dati all'interno di questo oggetto come blob.

Invio

Blob: i dati come blob.

`getChartId()`

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

Invio

Integer: un identificatore del grafico stabile.

`getContainerInfo()`

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

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

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

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

Invio

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico

`getHiddenDimensionStrategy()`

Restituisce la strategia da utilizzare per gestire le righe e le colonne nascoste. Il valore predefinito è IGNORE_ROWS.

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

const range = sheet.getRange('A1:B5');
const 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());

Invio

ChartHiddenDimensionStrategy: la strategia da utilizzare per le righe e le colonne nascoste.

`getMergeStrategy()`

Restituisce la strategia di unione utilizzata quando esiste più di un intervallo. Se MERGE_ROWS, le righe vengono unite; se MERGE_COLUMNS, le colonne vengono unite. Il valore predefinito è MERGE_COLUMNS.

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

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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());

Invio

ChartMergeStrategy - MERGE_ROWS se le righe sono unite in più intervalli; MERGE_COLUMNS se le colonne sono unite in più intervalli

`getNumHeaders()`

Restituisce il numero di righe o colonne dell'intervallo che vengono trattate come intestazioni.

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

const range = sheet.getRange('A1:B5');
const 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());

Invio

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.

Invio

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

`getRanges()`

Restituisce gli intervalli utilizzati da questo grafico come origine dati.

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

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

const ranges = chart.getRanges();

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

Invio

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

`getTransposeRowsAndColumns()`

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

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

const range = sheet.getRange('A1:B5');
const 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());

Invio

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

`modify()`

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

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

Invio

EmbeddedChartBuilder: un generatore per la creazione di grafici incorporati