Builder untuk diagram histogram. Untuk 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 | Membuat diagram untuk mencerminkan semua perubahan yang dilakukan pada diagram tersebut. |
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 mengenkapsulasi 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 di sumbu domain. |
set | Embedded | Menetapkan warna latar belakang untuk 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 posisi, mengubah tempat diagram muncul di sheet. |
set | Embedded | Menetapkan rentang untuk diagram. |
set | Embedded | Menggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (diakumulasikan). |
set | Embedded | Menetapkan judul diagram. |
set | Embedded | Menetapkan gaya teks judul diagram. |
set | Embedded | Menetapkan apakah baris dan kolom diagram ditransposisi. |
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 | Membuat sumbu rentang menjadi skala logaritmik (memerlukan semua nilai positif). |
Dokumentasi mendetail
add Range(range)
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 pembuatan rantai
as Area Chart()
Menetapkan jenis diagram ke AreaChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram area
as Bar Chart()
Menetapkan jenis diagram ke BarChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram batang
as Column Chart()
Menetapkan jenis diagram ke ColumnChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram kolom
as Combo Chart()
Menetapkan jenis diagram ke ComboChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram kombinasi
as Histogram Chart()
Menetapkan jenis diagram ke HistogramChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram histogram
as Line Chart()
Menetapkan jenis diagram ke LineChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram garis
as Pie Chart()
Menetapkan jenis diagram ke PieChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram lingkaran
as Scatter Chart()
Menetapkan jenis diagram ke ScatterChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram sebar
as Table Chart()
Menetapkan jenis diagram ke TableChart dan menampilkan Embedded
.
Pulang pergi
Embedded
— builder untuk diagram tabel
build()
Membuat diagram untuk mencerminkan semua perubahan yang dilakukan pada diagram tersebut.
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 Ranges()
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 pembuatan rantai
get Chart Type()
get Container()
Menampilkan Container
diagram, yang mengenkapsulasi 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 Ranges()
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 Range(range)
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 will render 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 // will not be removed, and will 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 pembuatan rantai
reverse Categories()
Membalikkan gambar deret di 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), ini berarti 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 Background Color(cssValue)
Menetapkan warna latar belakang untuk 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 Chart Type(type)
Mengubah jenis diagram. Tidak semua jenis diagram tersemat saat ini didukung. 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 digunakan untuk mengubah diagram ini. |
Pulang pergi
Embedded
— builder ini, untuk pembuatan rantai
set Colors(cssValues)
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 mewakili warna garis ke-n dalam diagram. |
Pulang pergi
Embedded
— Builder ini berguna untuk membuat rantai.
set Hidden Dimension Strategy(strategy)
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 pembuatan rantai
set Legend Position(position)
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 Legend Text Style(textStyle)
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 Merge Strategy(mergeStrategy)
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 pembuatan rantai
set Num Headers(headers)
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 pembuatan rantai
set Option(option, value)
Menetapkan opsi lanjutan untuk diagram ini. Untuk melihat daftar opsi yang tersedia, lihat Opsi konfigurasi chart.
Metode ini tidak memvalidasi apakah opsi yang Anda tentukan valid untuk jenis diagram ini atau apakah nilainya memiliki format/struktur yang benar.
Contoh ini menunjukkan cara mengubah judul dan menetapkan 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 pembuatan rantai.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Menetapkan posisi, mengubah tempat diagram muncul di 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 diatarkan 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 | Sudut kiri bawah diagram diimbangi dengan jumlah piksel ini. |
Pulang pergi
Embedded
— builder ini, untuk pembuatan rantai
set Range(start, end)
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 pada sumbu rentang. |
end | Number | Nilai untuk garis petak tertinggi pada sumbu rentang. |
Pulang pergi
Embedded
— Builder ini berguna untuk membuat rantai.
set Stacked()
Menggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (diakumulasikan). Secara default, tidak ada penumpukan.
Pulang pergi
Embedded
— Builder ini berguna untuk membuat rantai.
set Title(chartTitle)
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 Title Text Style(textStyle)
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 Transpose Rows And Columns(transpose)
Menetapkan apakah baris dan kolom diagram ditransposisi. Jika ditetapkan 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
ditransposisi. |
Pulang pergi
Embedded
— builder ini, untuk pembuatan rantai
set XAxis Text Style(textStyle)
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 XAxis Title(title)
Menambahkan judul ke sumbu horizontal. Judul dipusatkan 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 XAxis Title Text Style(textStyle)
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 YAxis Text Style(textStyle)
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 YAxis Title(title)
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 YAxis Title Text Style(textStyle)
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 Log Scale()
Membuat sumbu rentang menjadi skala logaritmik (memerlukan semua nilai 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.