Class EmbeddedChart

osadzony wykres,

Reprezentuje wykres umieszczony w arkuszu kalkulacyjnym.

Ten przykład pokazuje, jak zmodyfikować istniejący wykres:

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

Ten przykład pokazuje, jak utworzyć nowy wykres:

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

Metody

MetodaZwracany typKrótki opis
asDataSourceChart()DataSourceChartSłuży do przesyłania do wykresu instancji źródła danych, jeśli jest to wykres źródła danych lub null w innym przypadku.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane wewnątrz tego obiektu jako blob.
getChartId()IntegerZwraca stabilny identyfikator wykresu niepowtarzalnego w arkuszu kalkulacyjnym zawierającym wykres lub null, jeśli wykresu nie ma w arkuszu.
getContainerInfo()ContainerInfoZwraca informacje o tym, w którym miejscu arkusza znajduje się wykres.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyZwraca strategię używaną do obsługi ukrytych wierszy i kolumn.
getMergeStrategy()ChartMergeStrategyZwraca strategię scalania używaną w przypadku występowania więcej niż 1 zakresu.
getNumHeaders()IntegerZwraca liczbę wierszy i kolumn zakresu, które są traktowane jako nagłówki.
getOptions()ChartOptionsZwraca opcje tego wykresu, takie jak wysokość, kolory i osie.
getRanges()Range[]Zwraca zakresy, których ten wykres używa jako źródła danych.
getTransposeRowsAndColumns()BooleanJeśli wybierzesz true, wiersze i kolumny użyte do wypełnienia wykresu zostaną zmienione.
modify()EmbeddedChartBuilderZwraca wartość EmbeddedChartBuilder, która służy do modyfikowania tego wykresu.

Szczegółowa dokumentacja

asDataSourceChart()

Służy do przesyłania do wykresu instancji źródła danych, jeśli jest to wykres źródła danych lub null w innym przypadku.

Zwróć

DataSourceChart – wykres źródła danych,


getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf&quot”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".

Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowane. W większości blobów 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'.

Zwróć

Blob – dane jako obiekt blob.


getBlob()

Zwraca dane wewnątrz tego obiektu jako blob.

Zwróć

Blob – dane jako obiekt blob.


getChartId()

Zwraca stabilny identyfikator wykresu niepowtarzalnego w arkuszu kalkulacyjnym zawierającym wykres lub null, jeśli wykresu nie ma w arkuszu.

Zwróć

Integer – stabilny identyfikator wykresu,


getContainerInfo()

Zwraca informacje o tym, w którym miejscu arkusza znajduje się wykres.

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

Zwróć

ContainerInfo – obiekt zawierający pozycję kontenera wykresu,


getHiddenDimensionStrategy()

Zwraca strategię używaną do obsługi ukrytych wierszy i kolumn. Domyślna wartość to 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());

Zwróć

ChartHiddenDimensionStrategy – strategia używana do ukrywania wierszy i kolumn.


getMergeStrategy()

Zwraca strategię scalania używaną w przypadku występowania więcej niż 1 zakresu. Jeśli wiersz MERGE_ROWS jest scalony, kolumny MERGE_COLUMNS są scalane. Domyślna wartość to 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());

Zwróć

ChartMergeStrategyMERGE_ROWS, jeśli wiersze zostały scalone w wiele zakresów; MERGE_COLUMNS, jeśli kolumny zostały scalone w wiele zakresów


getNumHeaders()

Zwraca liczbę wierszy i kolumn zakresu, które są traktowane jako nagłówki.

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

Zwróć

Integer – liczba wierszy lub kolumn traktowanych jako nagłówki. Wartości ujemne oznaczają nagłówki wykryte automatycznie.


getOptions()

Zwraca opcje tego wykresu, takie jak wysokość, kolory i osie.

Zwrócone opcje są stałe.

Zwróć

ChartOptions – opcje tego wykresu, takie jak wysokość, kolory i osie.


getRanges()

Zwraca zakresy, których ten wykres używa jako źródła danych.

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

Zwróć

Range[] – tablica zakresów, które służą jako źródło danych na tym wykresie;


getTransposeRowsAndColumns()

Jeśli wybierzesz true, wiersze i kolumny użyte do wypełnienia wykresu zostaną zmienione. Domyślna wartość to 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());

Zwróć

Booleantrue, jeśli wiersze i kolumny użyte do utworzenia wykresu zostały przetranskrybowane.


modify()

Zwraca wartość EmbeddedChartBuilder, która służy do modyfikowania tego wykresu. Wywołaj sheet.updateChart(chart), aby zapisać zmiany.

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

Zwróć

EmbeddedChartBuilder – kreatywny wykres do umieszczenia na stronie