Class EmbeddedChart

Wykresumieszczony

Reprezentuje wykres, który został osadzony w arkuszu kalkulacyjnym.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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()DataSourceChartRzutuje na instancję wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub nullw przeciwnym razie.
getAs(contentType)BlobZwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane w tym obiekcie jako obiekt blob.
getChartId()IntegerZwraca stabilny identyfikator wykresu, który jest unikalny w arkuszu kalkulacyjnym zawierającym wykres lub null, jeśli wykres nie znajduje się w arkuszu kalkulacyjnym.
getContainerInfo()ContainerInfoZwraca informacje o tym, gdzie na arkuszu znajduje się wykres.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyZwraca strategię, która ma być używana do obsługi ukrytych wierszy i kolumn.
getMergeStrategy()ChartMergeStrategyZwraca strategię scalania używaną, gdy istnieje więcej niż jeden zakres.
getNumHeaders()IntegerZwraca liczbę wierszy lub kolumn w zakresie, 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 klikniesz true, wiersze i kolumny użyte do wypełnienia wykresu zostaną zamienione.
modify()EmbeddedChartBuilderZwraca obiekt EmbeddedChartBuilder, którego można użyć do zmodyfikowania tego wykresu.

Szczegółowa dokumentacja

asDataSourceChart()

Rzutuje na instancję wykresu źródła danych, jeśli wykres jest wykresem źródła danych, lub nullw przeciwnym razie.

Powrót

DataSourceChart – wykres źródła danych.

getAs(contentType)

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'. W przypadku dokumentu w Dokumentach Google 'text/markdown' jest również prawidłowe.

Powrót

Blob – dane w formie obiektu blob.

getBlob()

Zwraca dane w tym obiekcie jako obiekt blob.

Powrót

Blob – dane w formie obiektu blob.

getChartId()

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

Powrót

Integer – stały identyfikator wykresu.

getContainerInfo()

Zwraca informacje o tym, gdzie na arkuszu znajduje się wykres. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const containerInfo = chart.getContainerInfo();

// Logs the values 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ę, która ma być używana do obsługi ukrytych wierszy i kolumn. Domyślna wartość to IGNORE_ROWS. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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, która ma być używana w przypadku ukrytych wierszy i kolumn.

getMergeStrategy()

Zwraca strategię scalania używaną, gdy istnieje więcej niż jeden zakres. Jeśli MERGE_ROWS, wiersze zostaną scalone. Jeśli MERGE_COLUMNS, kolumny zostaną scalone. Domyślna wartość to MERGE_COLUMNS. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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 w wielu zakresach; MERGE_COLUMNS jeśli kolumny są scalone w wielu zakresach.

getNumHeaders()

Zwraca liczbę wierszy lub kolumn w zakresie, które są traktowane jako nagłówki. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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ą, że nagłówki zostały wykryte automatycznie.

getOptions()

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

Zwrócone opcje są niezmienne.

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. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const 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 klikniesz true, wiersze i kolumny użyte do wypełnienia wykresu zostaną zamienione. Domyślna wartość to false. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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 obiekt EmbeddedChartBuilder, którego można użyć do zmodyfikowania tego wykresu. Aby zapisać zmiany, kliknij sheet.updateChart(chart). 

const sheet = SpreadsheetApp.getActiveSheet();
let 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 wykresów do umieszczenia.