Halaman ini diterjemahkan oleh Cloud Translation API.

Class EmbeddedChart

Mewakili diagram yang telah disematkan ke dalam spreadsheet.

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`	Ditransmisikan ke instance diagram sumber data jika diagram adalah diagram sumber data, atau `null` sebaliknya.
`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 yang tersembunyi.
`getMergeStrategy()`	`ChartMergeStrategy`	Menampilkan strategi penggabungan yang digunakan jika 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()`

Ditransmisikan ke instance diagram sumber data jika diagram adalah diagram sumber data, atau null sebaliknya.

Pulang pergi

DataSourceChart — Diagram sumber data.

`getAs(contentType)`

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.

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, dari `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, atau `'image/png'` juga valid. Untuk dokumen Google Dokumen, `'text/markdown'` juga valid.

Pulang pergi

Blob — Data sebagai blob.

`getBlob()`

Menampilkan data di dalam objek ini sebagai blob.

Pulang pergi

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.

Pulang pergi

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

Pulang pergi

ContainerInfo — objek yang berisi posisi penampung diagram

`getHiddenDimensionStrategy()`

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

Pulang pergi

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

`getMergeStrategy()`

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

Pulang pergi

ChartMergeStrategy — MERGE_ROWS jika baris digabungkan menjadi 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());

Pulang pergi

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

`getOptions()`

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

Opsi yang ditampilkan tidak dapat diubah.

Pulang pergi

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

Pulang pergi

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

Pulang pergi

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

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

Pulang pergi

EmbeddedChartBuilder — builder untuk membuat diagram tersemat