Halaman ini diterjemahkan oleh Cloud Translation API.

Class EmbeddedChart

Menampilkan bagan yang telah disematkan ke dalam {i>spreadsheet<i}.

Contoh ini menunjukkan cara mengubah diagram yang ada:

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

Contoh ini menunjukkan cara membuat diagram baru:

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

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`asDataSourceChart()`	`DataSourceChart`	Melakukan transmisi ke instance diagram sumber data jika diagram berupa diagram sumber data, atau `null` jika tidak.
`getAs(contentType)`	`Blob`	Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
`getBlob()`	`Blob`	Menampilkan data di dalam objek ini sebagai blob.
`getChartId()`	`Integer`	Menampilkan ID stabil untuk diagram yang unik di seluruh spreadsheet yang berisi diagram atau `null` jika diagram tidak ada dalam spreadsheet.
`getContainerInfo()`	`ContainerInfo`	Menampilkan informasi tentang posisi diagram dalam sheet.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Menampilkan strategi yang akan digunakan untuk menangani baris dan kolom tersembunyi.
`getMergeStrategy()`	`ChartMergeStrategy`	Menampilkan strategi penggabungan yang digunakan saat ada lebih dari satu rentang.
`getNumHeaders()`	`Integer`	Menampilkan jumlah baris atau kolom rentang yang diperlakukan sebagai header.
`getOptions()`	`ChartOptions`	Menampilkan opsi untuk diagram ini, seperti tinggi, warna, dan sumbu.
`getRanges()`	`Range[]`	Menampilkan rentang yang digunakan diagram ini sebagai sumber data.
`getTransposeRowsAndColumns()`	`Boolean`	Jika `true`, baris dan kolom yang digunakan untuk mengisi diagram akan diganti.
`modify()`	`EmbeddedChartBuilder`	Menampilkan `EmbeddedChartBuilder` yang dapat digunakan untuk mengubah diagram ini.

Dokumentasi mendetail

`asDataSourceChart()`

Melakukan transmisi ke instance diagram sumber data jika diagram berupa diagram sumber data, atau null jika tidak.

Return

DataSourceChart — Diagram sumber data.

`getAs(contentType)`

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, dianggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang sudah ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat untuk sementara mungkin dikenai kuota yang lebih ketat.

Parameter

Nama	Jenis	Deskripsi
`contentType`	`String`	Jenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, `'application/pdf'` adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, atau `'image/png'` juga valid.

Return

Blob — Data sebagai blob.

`getBlob()`

Menampilkan data di dalam objek ini sebagai blob.

Return

Blob — Data sebagai blob.

`getChartId()`

Menampilkan ID stabil untuk diagram yang unik di seluruh spreadsheet yang berisi diagram atau null jika diagram tidak ada dalam spreadsheet.

Return

Integer — ID diagram yang stabil.

`getContainerInfo()`

Menampilkan informasi tentang posisi diagram dalam sheet.

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

Return

ContainerInfo — objek yang berisi posisi penampung diagram

`getHiddenDimensionStrategy()`

Menampilkan strategi yang akan digunakan untuk menangani baris dan kolom tersembunyi. Default-nya adalah 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());

Return

ChartHiddenDimensionStrategy — Strategi yang akan digunakan untuk baris dan kolom tersembunyi.

`getMergeStrategy()`

Menampilkan strategi penggabungan yang digunakan saat ada lebih dari satu rentang. Jika MERGE_ROWS, baris akan digabungkan; jika MERGE_COLUMNS, kolom akan digabungkan. Default-nya adalah 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());

Return

ChartMergeStrategy — MERGE_ROWS jika baris digabungkan di beberapa rentang; MERGE_COLUMNS jika kolom digabungkan di beberapa rentang

`getNumHeaders()`

Menampilkan jumlah baris atau kolom rentang yang diperlakukan sebagai header.

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

Return

Integer — Jumlah baris atau kolom yang diperlakukan sebagai header. Nilai negatif menunjukkan bahwa header terdeteksi secara otomatis.

`getOptions()`

Menampilkan opsi untuk diagram ini, seperti tinggi, warna, dan sumbu.

Opsi yang ditampilkan tidak dapat diubah.

Return

ChartOptions — Opsi untuk diagram ini, seperti tinggi, warna, dan sumbu.

`getRanges()`

Menampilkan rentang yang digunakan diagram ini sebagai sumber data.

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

Return

Range[] — array rentang yang berfungsi sebagai sumber data diagram ini

`getTransposeRowsAndColumns()`

Jika true, baris dan kolom yang digunakan untuk mengisi diagram akan diganti. Default-nya adalah 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());

Return

Boolean — true jika baris dan kolom yang digunakan untuk membuat diagram ditransposisikan.

`modify()`

Menampilkan EmbeddedChartBuilder yang dapat digunakan untuk mengubah diagram ini. Panggil sheet.updateChart(chart) untuk menyimpan perubahan.

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

Return

EmbeddedChartBuilder — builder untuk membuat diagram sematan