Class EmbeddedChart

EmbeddedChart

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()DataSourceChartPrzesyła do instancji wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub null w przeciwnym razie.
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 obiekt blob.
getChartId()IntegerZwraca stały identyfikator wykresu, który jest unikalny w całym arkuszu kalkulacyjnym zawierającym wykres lub null, jeśli nie znajduje się on w arkuszu kalkulacyjnym.
getContainerInfo()ContainerInfoZwraca informacje o pozycji wykresu w arkuszu.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyZwraca strategię obsługi ukrytych wierszy i kolumn.
getMergeStrategy()ChartMergeStrategyZwraca strategię scalania używaną, gdy istnieje więcej niż 1 zakres.
getNumHeaders()IntegerZwraca liczbę wierszy lub kolumn w zakresie traktowanych jako nagłówki.
getOptions()ChartOptionsZwraca opcje 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 true, wiersze i kolumny używane do wypełniania wykresu zostaną przełączone.
modify()EmbeddedChartBuilderZwraca wartość EmbeddedChartBuilder, której można użyć do zmodyfikowania tego wykresu.

Szczegółowa dokumentacja

asDataSourceChart()

Przesyła do instancji wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub null w przeciwnym razie.

Powrót

DataSourceChart – wykres źródła danych.

getAs(contentType)

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown'.

Powrót

Blob – dane w postaci obiektu blob.

getBlob()

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci obiektu blob.

getChartId()

Zwraca stały identyfikator wykresu, który jest unikalny w całym arkuszu kalkulacyjnym zawierającym wykres lub null, jeśli nie znajduje się on w arkuszu kalkulacyjnym.

Powrót

Integer – niezmienny identyfikator wykresu.

getContainerInfo()

Zwraca informacje o pozycji wykresu w arkuszu. 

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

Powrót

ContainerInfo – obiekt zawierający pozycję kontenera wykresu.

getHiddenDimensionStrategy()

Zwraca strategię 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());

Powrót

ChartHiddenDimensionStrategy – strategia używana w przypadku ukrytych wierszy i kolumn.

getMergeStrategy()

Zwraca strategię scalania używaną, gdy istnieje więcej niż 1 zakres. Jeśli MERGE_ROWS, wiersz jest scalany; jeśli MERGE_COLUMNS, kolumny zostaną scalone. 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());

Powrót

ChartMergeStrategy – MERGE_ROWS, jeśli wiersze są scalone z kilku stron zakresy MERGE_COLUMNS, jeśli kolumny zostały scalone w wielu zakresach

getNumHeaders()

Zwraca liczbę wierszy lub kolumn w zakresie traktowanych 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());

Powrót

Integer – liczba wierszy lub kolumn traktowanych jako nagłówki. Wartości ujemne wskazują nagłówki są wykrywane automatycznie.

getOptions()

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

Zwracanych opcji nie można zmienić.

Powrót

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

Powrót

Range[] – tablica zakresów, które służą jako źródło danych tego wykresu

getTransposeRowsAndColumns()

Jeśli true, wiersze i kolumny używane do wypełniania wykresu zostaną przełączone. 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());

Powrót

Boolean – true, jeśli wiersze i kolumny użyte do utworzenia wykresu są transponowane.

modify()

Zwraca wartość EmbeddedChartBuilder, której można użyć do zmodyfikowania tego wykresu. Aby zapisać zmiany, wywołaj sheet.updateChart(chart). 

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

Powrót

EmbeddedChartBuilder – narzędzie do tworzenia osadzonych wykresów