Class EmbeddedChart

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.

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

Powrót

Blob – dane w postaci obiektu blob.

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci obiektu blob.

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.

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.

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.

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

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.

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.

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

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.

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