Ta strona została przetłumaczona przez Cloud Translation API.

Class 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

Metoda	Zwracany typ	Krótki opis
`asDataSourceChart()`	`DataSourceChart`	Służy do przesyłania do instancji wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub `null` w innym przypadku.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwracaj dane wewnątrz tego obiektu jako obiekt blob.
`getChartId()`	`Integer`	Zwraca stabilny identyfikator wykresu, który jest unikalny w całym arkuszu kalkulacyjnym zawierającym wykres, lub `null`, jeśli wykres nie znajduje się w arkuszu kalkulacyjnym.
`getContainerInfo()`	`ContainerInfo`	Zwraca informacje o pozycji wykresu w arkuszu.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Zwraca strategię używaną do obsługi ukrytych wierszy i kolumn.
`getMergeStrategy()`	`ChartMergeStrategy`	Zwraca strategię scalania, jeśli istnieje więcej niż jeden zakres.
`getNumHeaders()`	`Integer`	Zwraca liczbę wierszy lub kolumn zakresu traktowanych jako nagłówki.
`getOptions()`	`ChartOptions`	Zwraca opcje wykresu, takie jak wysokość, kolory i osie.
`getRanges()`	`Range[]`	Zwraca zakresy, których używa ten wykres jako źródło danych.
`getTransposeRowsAndColumns()`	`Boolean`	Jeśli ma wartość `true`, wiersze i kolumny używane do wypełniania wykresu są przełączane.
`modify()`	`EmbeddedChartBuilder`	Zwraca wartość `EmbeddedChartBuilder`, której można użyć do zmodyfikowania tego wykresu.

Szczegółowa dokumentacja

`asDataSourceChart()`

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

Powroty

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 do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.

Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest `'application/pdf'`. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`.

Powroty

Blob – dane w postaci obiektu blob.

`getBlob()`

Zwracaj dane wewnątrz tego obiektu jako obiekt blob.

Powroty

Blob – dane w postaci obiektu blob.

`getChartId()`

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

Powroty

Integer – stabilny 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());

Powroty

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

Powroty

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

`getMergeStrategy()`

Zwraca strategię scalania, jeśli istnieje więcej niż jeden zakres. Jeśli ma wartość MERGE_ROWS, wiersz jest scalony, a jeśli ma wartość MERGE_COLUMNS, kolumny są 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());

Powroty

ChartMergeStrategy – MERGE_ROWS, jeśli wiersze są scalone między wieloma zakresami; MERGE_COLUMNS, jeśli kolumny są scalone z wielu zakresów

`getNumHeaders()`

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

Powroty

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

`getOptions()`

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

Zwracanych opcji nie można zmienić.

Powroty

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

`getRanges()`

Zwraca zakresy, których używa ten wykres jako źródło 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());
}

Powroty

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

`getTransposeRowsAndColumns()`

Jeśli ma wartość true, wiersze i kolumny używane do wypełniania wykresu są przełączane. Wartość domyślna 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());

Powroty

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

`modify()`

Zwraca wartość EmbeddedChartBuilder, której można użyć do zmodyfikowania tego wykresu. Wywołaj polecenie 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);

Powroty

EmbeddedChartBuilder – kreator do tworzenia umieszczonych wykresów