Class EmbeddedChart

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

MetodoTipo restituitoBreve descrizione
asDataSourceChart()DataSourceChartTrasmette la trasmissione a un'istanza del grafico di origine dati se il grafico è un grafico di origine dati oppure null negli altri casi.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()BlobRestituisce i dati all'interno dell'oggetto sotto forma di blob.
getChartId()IntegerRestituisce un identificatore stabile per il grafico, univoco nel foglio di lavoro contenente 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 gestire le righe e le 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 il grafico, come altezza, colori e assi.
getRanges()Range[]Restituisce gli intervalli utilizzati dal grafico come origine dati.
getTransposeRowsAndColumns()BooleanSe true, le righe e le colonne utilizzate per completare il grafico vengono invertite.
modify()EmbeddedChartBuilderRestituisce un valore EmbeddedChartBuilder che può essere utilizzato per modificare il grafico.

Documentazione dettagliata

asDataSourceChart()

Trasmette la trasmissione a un'istanza del grafico di origine dati se il grafico è un grafico di origine dati oppure null negli altri casi.

Invio

DataSourceChart: il grafico dell'origine dati.

getAs(contentType)

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

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.

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, vengono visualizzati anche i valori 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png' valida. Per un documento di Documenti Google è valido anche 'text/markdown'.

Invio

Blob: i dati come blob.

getBlob()

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

Invio

Blob: i dati come blob.

getChartId()

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

Invio

Integer: un identificatore stabile del grafico.

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

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. 

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

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. 

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

Invio

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

getNumHeaders()

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

// 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 le intestazioni vengono rilevati automaticamente.

getOptions()

Restituisce le opzioni per il grafico, come 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 dal 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());
}

Invio

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

getTransposeRowsAndColumns()

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

Invio

Boolean: true se le righe e le colonne utilizzate per costruire il grafico vengono trasposti.

modify()

Restituisce un valore EmbeddedChartBuilder che può essere utilizzato per modificare il 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);

Invio

EmbeddedChartBuilder: uno strumento per la creazione di grafici incorporati