Class EmbeddedChart

Graficoincorporato

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

MetodoTipo restituitoBreve descrizione
asDataSourceChart()DataSourceChartEsegue il cast a un'istanza del grafico dell'origine dati se il grafico è un grafico dell'origine dati o null altrimenti.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBlob()BlobRestituisce i dati all'interno di questo oggetto come blob.
getChartId()IntegerRestituisce un identificatore stabile per il grafico univoco nel foglio di lavoro contenente il grafico o null se il grafico non si trova in un foglio di lavoro.
getContainerInfo()ContainerInfoRestituisce informazioni sulla posizione del grafico all'interno di un foglio.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyRestituisce la strategia da utilizzare per la gestione di righe e colonne nascoste.
getMergeStrategy()ChartMergeStrategyRestituisce la strategia di unione utilizzata quando esiste più di un intervallo.
getNumHeaders()IntegerRestituisce il numero di righe o colonne dell'intervallo trattate come intestazioni.
getOptions()ChartOptionsRestituisce le opzioni per questo grafico, come altezza, colori e assi.
getRanges()Range[]Restituisce gli intervalli che questo grafico utilizza come origine dati.
getTransposeRowsAndColumns()BooleanSe true, le righe e le colonne utilizzate per compilare il grafico vengono invertite.
modify()EmbeddedChartBuilderRestituisce un EmbeddedChartBuilder che può essere utilizzato per modificare questo grafico.

Documentazione dettagliata

asDataSourceChart()

Esegue il cast a un'istanza del grafico dell'origine dati se il grafico è un grafico dell'origine dati o null altrimenti.

Indietro

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, si presume 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ù rigide.

Parametri

NomeTipoDescrizione
contentTypeStringIl 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, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento Google, è valido anche 'text/markdown'.

Indietro

Blob: i dati come blob.

getBlob()

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

Indietro

Blob: i dati come blob.

getChartId()

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

Indietro

Integer: un identificatore stabile del grafico.

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

Indietro

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. 

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

Indietro

ChartHiddenDimensionStrategy: la strategia da utilizzare per righe e 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());

Indietro

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

Indietro

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, come altezza, colori e assi.

Le opzioni restituite sono immutabili.

Indietro

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

getRanges()

Restituisce gli intervalli che questo grafico utilizza 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());
}

Indietro

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

getTransposeRowsAndColumns()

Se true, le righe e le colonne utilizzate per compilare il grafico vengono invertite. 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());

Indietro

Boolean — True se le righe e le colonne utilizzate per costruire il grafico sono trasposte.

modify()

Restituisce un EmbeddedChartBuilder che può essere utilizzato per modificare questo grafico. Invoca 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);

Indietro

EmbeddedChartBuilder: un builder per creare grafici incorporati.