Class EmbeddedChart

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,

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

Zwróć

Blob – dane jako obiekt blob.

Zwraca dane wewnątrz tego obiektu jako blob.

Zwróć

Blob – dane jako obiekt blob.

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,

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,

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.

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óć

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

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.

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.

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;

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óć

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

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