Mewakili diagram yang disematkan ke 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 | Melakukan transmisi ke instance diagram sumber data jika diagram adalah 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 | Tampilkan 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 di spreadsheet. |
getContainerInfo() | ContainerInfo | Menampilkan informasi tentang posisi diagram dalam sheet. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Menampilkan strategi yang 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 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 dialihkan. |
modify() | EmbeddedChartBuilder | Menampilkan EmbeddedChartBuilder yang dapat digunakan untuk mengubah diagram ini. |
Dokumentasi mendetail
asDataSourceChart()
Melakukan transmisi ke instance diagram sumber data jika diagram adalah 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, mengasumsikan bahwa bagian dari nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat mungkin tunduk pada kuota yang lebih ketat untuk sementara.
Parameter
Name | 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, salah satu dari 'image/bmp' , 'image/gif' , 'image/jpeg' , atau 'image/png' juga valid. |
Return
Blob
- Data sebagai blob.
getBlob()
getChartId()
Menampilkan ID stabil untuk diagram yang unik di seluruh spreadsheet yang berisi diagram atau null
jika diagram tidak ada di 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 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 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 dialihkan. Nilai defaultnya 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 diubah.
modify()
Menampilkan EmbeddedChartBuilder
yang dapat digunakan untuk mengubah diagram ini. Panggil sheet.updateChart(chart)
untuk menyimpan perubahan apa pun.
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