Builder untuk diagram area. Untuk mengetahui detail selengkapnya, lihat dokumentasi Gviz.
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
add | Embedded | Menambahkan rentang ke diagram yang diubah oleh builder ini. |
as | Embedded | Menetapkan jenis diagram ke AreaChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke BarChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke ColumnChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke ComboChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke HistogramChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke LineChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke PieChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke ScatterChart dan menampilkan Embedded. |
as | Embedded | Menetapkan jenis diagram ke TableChart dan menampilkan Embedded. |
build() | Embedded | Membangun diagram untuk mencerminkan semua perubahan yang dilakukan padanya. |
clear | Embedded | Menghapus semua rentang dari diagram yang diubah oleh builder ini. |
get | Chart | Menampilkan jenis diagram saat ini. |
get | Container | Menampilkan Container diagram, yang mencakup tempat diagram muncul di sheet. |
get | Range[] | Menampilkan salinan daftar rentang yang saat ini menyediakan data untuk diagram ini. |
remove | Embedded | Menghapus rentang yang ditentukan dari diagram yang diubah oleh builder ini. |
reverse | Embedded | Membalikkan gambar deret dalam sumbu domain. |
set | Embedded | Menetapkan warna latar belakang diagram. |
set | Embedded | Mengubah jenis diagram. |
set | Embedded | Menetapkan warna untuk garis dalam diagram. |
set | Embedded | Menetapkan strategi yang akan digunakan untuk baris dan kolom tersembunyi. |
set | Embedded | Menetapkan posisi legenda sehubungan dengan diagram. |
set | Embedded | Menetapkan gaya teks legenda diagram. |
set | Embedded | Menetapkan strategi penggabungan yang akan digunakan jika ada lebih dari satu rentang. |
set | Embedded | Menetapkan jumlah baris atau kolom rentang yang harus diperlakukan sebagai header. |
set | Embedded | Menetapkan opsi lanjutan untuk diagram ini. |
set | Embedded | Menetapkan gaya untuk titik dalam garis. |
set | Embedded | Menetapkan posisi, mengubah tempat munculnya diagram pada sheet. |
set | Embedded | Menetapkan rentang untuk diagram. |
set | Embedded | Menggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (terakumulasi). |
set | Embedded | Menetapkan judul diagram. |
set | Embedded | Menetapkan gaya teks judul diagram. |
set | Embedded | Menetapkan apakah baris dan kolom diagram diubah urutannya. |
set | Embedded | Menetapkan gaya teks sumbu horizontal. |
set | Embedded | Menambahkan judul ke sumbu horizontal. |
set | Embedded | Menetapkan gaya teks judul sumbu horizontal. |
set | Embedded | Menetapkan gaya teks sumbu vertikal. |
set | Embedded | Menambahkan judul ke sumbu vertikal. |
set | Embedded | Menetapkan gaya teks judul sumbu vertikal. |
use | Embedded | Mengubah sumbu rentang menjadi skala logaritmik (semua nilai harus positif). |
Dokumentasi mendetail
add
Menambahkan rentang ke diagram yang diubah oleh builder ini. Tidak menambahkan rentang jika sudah ditambahkan ke diagram.
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(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
range | Range | Rentang yang akan ditambahkan. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
as
Menetapkan jenis diagram ke AreaChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram area.
as
Menetapkan jenis diagram ke BarChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram batang.
as
Menetapkan jenis diagram ke ColumnChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram kolom.
as
Menetapkan jenis diagram ke ComboChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram kombinasi.
as
Menetapkan jenis diagram ke HistogramChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram histogram.
as
Menetapkan jenis diagram ke LineChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram garis.
as
Menetapkan jenis diagram ke PieChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram lingkaran.
as
Menetapkan jenis diagram ke ScatterChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram sebar.
as
Menetapkan jenis diagram ke TableChart dan menampilkan Embedded.
Pulang pergi
Embedded — Builder untuk diagram tabel.
build()
Membangun diagram untuk mencerminkan semua perubahan yang dilakukan padanya.
Metode ini tidak otomatis menggambar diagram di atas spreadsheet. Diagram baru harus disisipkan melalui sheet.insertChart(chart), dan diagram yang ada harus diperbarui melalui sheet.updateChart(chart).
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Pulang pergi
Embedded — Diagram yang dibuat, yang masih harus ditambahkan ke spreadsheet.
clear
Menghapus semua rentang dari diagram yang diubah oleh builder ini.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the // existing formatting of the chart. const chart = sheet.getCharts()[0]; const newChart = chart.modify() .clearRanges() .addRange(sheet.getRange('A1:A5')) .addRange(sheet.getRange('B1:B5')) .build(); sheet.updateChart(newChart);
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
get
get
Menampilkan Container diagram, yang mencakup tempat diagram muncul di sheet.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); // This method returns the exact same data as Chart#getContainerInfo() const containerInfo = chartBuilder.getContainer(); // 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(), );
Pulang pergi
Container — Objek yang berisi posisi penampung diagram.
get
Menampilkan salinan daftar rentang yang saat ini menyediakan data untuk diagram ini. Gunakan add dan remove untuk mengubah daftar ini.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); const ranges = chartBuilder.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()); }
Pulang pergi
Range[] — Array rentang yang berfungsi sebagai sumber data diagram yang akan dibuat.
remove
Menghapus rentang yang ditentukan dari diagram yang diubah oleh builder ini. Tidak menampilkan error jika rentang tidak ada dalam diagram ini.
Rentang yang dihapus harus cocok dengan rentang yang ditambahkan melalui add; jika tidak, tidak ada perubahan yang dilakukan pada diagram. Metode ini tidak dapat digunakan untuk menghapus sebagian nilai dari rentang.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const firstRange = sheet.getRange('A1:B5'); const secondRange = sheet.getRange('A6:B8'); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(firstRange) // This range renders in a different color .addRange(secondRange) .setPosition(5, 5, 0, 0); // Note that you can use either of these two formats, but the range // MUST match up with a range that was added via addRange(), or it // is not removed, and does not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
range | Range | Rentang yang akan dihapus. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
reverse
Membalikkan gambar deret dalam sumbu domain. Untuk diagram rentang vertikal (seperti diagram garis, area, atau kolom), ini berarti sumbu horizontal digambar dari kanan ke kiri. Untuk diagram rentang horizontal (seperti diagram batang), artinya sumbu vertikal digambar dari atas ke bawah. Untuk diagram lingkaran, ini berarti irisan digambar berlawanan arah jarum jam.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan warna latar belakang diagram.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
css | String | Nilai CSS untuk warna (seperti "blue" atau "#00f"). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Mengubah jenis diagram. Tidak semua jenis diagram sematan didukung saat ini. Lihat Chart.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
type | Chart | Jenis yang akan diubah menjadi diagram ini. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan warna untuk garis dalam diagram.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
css | String[] | Array nilai CSS warna, seperti ["red", "#acf"]. Elemen ke-n dalam array merepresentasikan warna garis ke-n dalam diagram. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan strategi yang akan digunakan untuk baris dan kolom tersembunyi. Default-nya adalah 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(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
strategy | Chart | Strategi yang akan digunakan untuk baris dan kolom tersembunyi. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan posisi legenda sehubungan dengan diagram. Secara default, tidak ada legenda.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
position | Position | Posisi legenda. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan gaya teks legenda diagram.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk legenda diagram. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan strategi penggabungan yang akan digunakan jika ada lebih dari satu rentang. Jika MERGE_ROWS, baris akan digabungkan; jika MERGE_COLUMNS, kolom akan digabungkan. Default-nya adalah MERGE_COLUMNS.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B10'); const range2 = sheet.getRange('C:C10'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
merge | Chart | Strategi penggabungan yang akan digunakan. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan jumlah baris atau kolom rentang yang harus diperlakukan sebagai header.
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(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
headers | Integer | Jumlah baris atau kolom yang akan diperlakukan sebagai header. Nilai negatif menyebabkan header terdeteksi secara otomatis. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan opsi lanjutan untuk diagram ini. Untuk melihat daftar opsi yang tersedia, lihat Opsi konfigurasi diagram.
Metode ini tidak memvalidasi apakah opsi yang Anda tentukan valid untuk jenis diagram ini atau apakah nilai memiliki format/struktur yang benar.
Contoh ini menunjukkan cara mengubah judul dan menyetel legenda.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getSheets()[0]; const chart = sheet.newChart() .setOption('title', 'Earnings projections') .setOption('legend', { position: 'top', textStyle: { color: 'blue', fontSize: 16 }, }).build();
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
option | String | Nama opsi. |
value | Object | Nilai opsi. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan gaya untuk titik dalam garis. Secara default, titik tidak memiliki gaya tertentu, dan hanya garis yang terlihat.
// Creates a line chart builder and sets large point style. const builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
style | Point | Gaya yang akan digunakan untuk titik dalam garis. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
Lihat juga
set
Menetapkan posisi, mengubah tempat munculnya diagram pada sheet. anchor dan anchor diindeks 1.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
anchor | Integer | Sisi atas diagram ditambatkan di baris ini. |
anchor | Integer | Sisi kiri diagram ditambatkan di kolom ini. |
offsetX | Integer | Sudut kanan atas diagram diimbangi dengan jumlah piksel ini. |
offsetY | Integer | Pojok kiri bawah diagram di-offset sebanyak piksel ini. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan rentang untuk diagram.
Jika ada titik data yang berada di luar rentang, rentang akan diperluas untuk menyertakan titik data tersebut.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
start | Number | Nilai untuk garis petak terendah dari sumbu rentang. |
end | Number | Nilai untuk garis petak tertinggi dari sumbu rentang. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (terakumulasi). Secara default, tidak ada penumpukan.
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan judul diagram. Judul ditampilkan di tengah di atas diagram.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
chart | String | judul diagram. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan gaya teks judul diagram.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk judul diagram. Anda dapat membuat objek Text dengan memanggil Charts.newTextStyle(). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan apakah baris dan kolom diagram diubah urutannya. Jika disetel ke true, baris dan kolom akan ditukar. Nilai defaultnya adalah false.
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) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
transpose | Boolean | Jika true, baris dan kolom yang digunakan untuk membuat diagram akan ditransposisikan. |
Pulang pergi
Embedded — Builder ini, untuk membuat rantai.
set
Menetapkan gaya teks sumbu horizontal.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek Text dengan memanggil Charts.newTextStyle(). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menambahkan judul ke sumbu horizontal. Judul berada di tengah dan muncul di bawah label nilai sumbu.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
title | String | Judul untuk sumbu X. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan gaya teks judul sumbu horizontal.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek Text dengan memanggil Charts.newTextStyle(). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan gaya teks sumbu vertikal.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek Text dengan memanggil Charts.newTextStyle(). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menambahkan judul ke sumbu vertikal. Judul dipusatkan dan muncul di sebelah kiri label nilai.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
title | String | Judul untuk sumbu Y. |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
set
Menetapkan gaya teks judul sumbu vertikal.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek Text dengan memanggil Charts.newTextStyle(). |
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.
use
Mengubah sumbu rentang menjadi skala logaritmik (semua nilai harus positif). Sumbu rentang adalah sumbu vertikal untuk diagram vertikal (seperti garis, area, atau kolom) dan sumbu horizontal untuk diagram horizontal (seperti batang).
Pulang pergi
Embedded — Builder ini berguna untuk membuat rantai.