Builder untuk diagram tabel. Untuk detail selengkapnya, lihat dokumentasi Gviz.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addRange(range) | EmbeddedChartBuilder | Menambahkan rentang ke diagram yang diubah oleh builder ini. |
asAreaChart() | EmbeddedAreaChartBuilder | Menetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder . |
asBarChart() | EmbeddedBarChartBuilder | Menetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder . |
asColumnChart() | EmbeddedColumnChartBuilder | Menetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder . |
asComboChart() | EmbeddedComboChartBuilder | Menetapkan jenis diagram ke KomboChart dan menampilkan EmbeddedComboChartBuilder . |
asHistogramChart() | EmbeddedHistogramChartBuilder | Menetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder . |
asLineChart() | EmbeddedLineChartBuilder | Menetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder . |
asPieChart() | EmbeddedPieChartBuilder | Menetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder . |
asScatterChart() | EmbeddedScatterChartBuilder | Menetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder . |
asTableChart() | EmbeddedTableChartBuilder | Menetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder . |
build() | EmbeddedChart | Membuat diagram untuk mencerminkan semua perubahan yang dibuat pada diagram. |
clearRanges() | EmbeddedChartBuilder | Menghapus semua rentang dari diagram yang diubah oleh builder ini. |
enablePaging(enablePaging) | EmbeddedTableChartBuilder | Menetapkan apakah akan mengaktifkan pembagian halaman melalui data. |
enablePaging(pageSize) | EmbeddedTableChartBuilder | Mengaktifkan paging dan menetapkan jumlah baris di setiap halaman. |
enablePaging(pageSize, startPage) | EmbeddedTableChartBuilder | Mengaktifkan paging, menetapkan jumlah baris di setiap halaman dan halaman tabel pertama yang akan ditampilkan (nomor halaman berbasis nol). |
enableRtlTable(rtlEnabled) | EmbeddedTableChartBuilder | Menambahkan dukungan dasar untuk bahasa yang ditulis dari kanan ke kiri (seperti bahasa Arab atau Ibrani) dengan membalik urutan kolom tabel, sehingga kolom nol adalah kolom paling kanan, dan kolom terakhir adalah kolom paling kiri. |
enableSorting(enableSorting) | EmbeddedTableChartBuilder | Menetapkan apakah akan mengurutkan kolom saat pengguna mengklik judul kolom. |
getChartType() | ChartType | Menampilkan jenis diagram saat ini. |
getContainer() | ContainerInfo | Tampilkan diagram ContainerInfo , yang mengenkapsulasi tempat diagram muncul pada sheet. |
getRanges() | Range[] | Menampilkan salinan daftar rentang yang saat ini menyediakan data untuk diagram ini. |
removeRange(range) | EmbeddedChartBuilder | Menghapus rentang yang ditentukan dari diagram yang dimodifikasi oleh builder ini. |
setChartType(type) | EmbeddedChartBuilder | Mengubah jenis diagram. |
setFirstRowNumber(number) | EmbeddedTableChartBuilder | Menetapkan nomor baris untuk baris pertama dalam tabel data. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | Menetapkan strategi yang akan digunakan untuk baris dan kolom tersembunyi. |
setInitialSortingAscending(column) | EmbeddedTableChartBuilder | Menetapkan indeks kolom yang sesuai dengan tabel yang pertama kali diurutkan (menaik). |
setInitialSortingDescending(column) | EmbeddedTableChartBuilder | Menetapkan indeks kolom yang sesuai dengan tabel yang harus diurutkan pertama kali (menurun). |
setMergeStrategy(mergeStrategy) | EmbeddedChartBuilder | Menetapkan strategi penggabungan yang akan digunakan saat terdapat lebih dari satu rentang. |
setNumHeaders(headers) | EmbeddedChartBuilder | Menetapkan jumlah baris atau kolom rentang yang harus diperlakukan sebagai header. |
setOption(option, value) | EmbeddedChartBuilder | Menetapkan opsi lanjutan untuk diagram ini. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | EmbeddedChartBuilder | Menetapkan posisi, mengubah lokasi kemunculan diagram pada sheet. |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | Menetapkan apakah baris dan kolom diagram ditransposisikan. |
showRowNumberColumn(showRowNumber) | EmbeddedTableChartBuilder | Menetapkan apakah akan menampilkan nomor baris sebagai kolom pertama tabel. |
useAlternatingRowStyle(alternate) | EmbeddedTableChartBuilder | Menetapkan apakah gaya warna alternatif ditetapkan ke baris ganjil dan genap pada diagram tabel. |
Dokumentasi mendetail
addRange(range)
Menambahkan rentang ke diagram yang diubah oleh builder ini. Tidak menambahkan rentang jika sudah ditambahkan ke diagram.
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(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang akan ditambahkan. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
asAreaChart()
Menetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder
.
Return
EmbeddedAreaChartBuilder
— builder untuk diagram area
asBarChart()
Menetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder
.
Return
EmbeddedBarChartBuilder
— builder untuk diagram batang
asColumnChart()
Menetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder
.
Return
EmbeddedColumnChartBuilder
— builder untuk diagram kolom
asComboChart()
Menetapkan jenis diagram ke KomboChart dan menampilkan EmbeddedComboChartBuilder
.
Return
EmbeddedComboChartBuilder
— builder untuk diagram kombinasi
asHistogramChart()
Menetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder
.
Return
EmbeddedHistogramChartBuilder
— builder untuk diagram histogram
asLineChart()
Menetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder
.
Return
EmbeddedLineChartBuilder
— builder untuk diagram garis
asPieChart()
Menetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder
.
Return
EmbeddedPieChartBuilder
— builder untuk diagram lingkaran
asScatterChart()
Menetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder
.
Return
EmbeddedScatterChartBuilder
— builder untuk diagram sebar
asTableChart()
Menetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder
.
Return
EmbeddedTableChartBuilder
— builder untuk diagram tabel
build()
Membuat diagram untuk mencerminkan semua perubahan yang dibuat pada diagram.
Metode ini tidak secara otomatis menggambar bagan di atas {i>spreadsheet<i}. Diagram baru
harus disisipkan melalui sheet.insertChart(chart)
, dan diagram yang ada harus diperbarui
melalui sheet.updateChart(chart)
.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Return
EmbeddedChart
— diagram yang dibuat, yang tetap harus ditambahkan ke spreadsheet
clearRanges()
Menghapus semua rentang dari diagram yang diubah oleh builder ini.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the existing // formatting of the chart. var chart = sheet.getCharts()[0]; var newChart = chart .modify() .clearRanges() .addRange(sheet.getRange("A1:A5")) .addRange(sheet.getRange("B1:B5")) .build(); sheet.updateChart(newChart);
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
enablePaging(enablePaging)
Menetapkan apakah akan mengaktifkan pembagian halaman melalui data.
Perilaku defaultnya adalah paging dinonaktifkan. Jika paging diaktifkan, ukuran halaman default adalah 10.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
enablePaging | Boolean | true jika paging harus diaktifkan, false jika tidak. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
enablePaging(pageSize)
Mengaktifkan paging dan menetapkan jumlah baris di setiap halaman.
Ukuran halaman default adalah 10.
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
pageSize | Integer | Jumlah baris di setiap halaman tabel. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
enablePaging(pageSize, startPage)
Mengaktifkan paging, menetapkan jumlah baris di setiap halaman dan halaman tabel pertama yang akan ditampilkan (nomor halaman berbasis nol).
Ukuran halaman default adalah 10, dan halaman awal default adalah 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
pageSize | Integer | Jumlah baris di setiap halaman tabel. |
startPage | Integer | Halaman tabel pertama yang akan ditampilkan (nomor halaman berbasis nol). |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
enableRtlTable(rtlEnabled)
Menambahkan dukungan dasar untuk bahasa yang ditulis dari kanan ke kiri (seperti bahasa Arab atau Ibrani) dengan membalik urutan kolom tabel, sehingga kolom nol adalah kolom paling kanan, dan kolom terakhir adalah kolom paling kiri.
Hal ini hanya memengaruhi urutan tampilannya, bukan indeks kolom dalam data pokok. Tampilan bahasa dua arah (BiDi) penuh tidak didukung oleh visualisasi tabel meskipun dengan opsi ini. Opsi ini akan diabaikan jika Anda mengaktifkan paging (menggunakan opsi halaman), atau jika tabel memiliki scroll bar karena Anda telah menetapkan opsi tinggi dan lebar yang lebih kecil dari ukuran tabel yang diperlukan. Perilaku defaultnya adalah dukungan RTL dinonaktifkan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rtlEnabled | Boolean | true jika dukungan kanan-ke-kiri harus diaktifkan, false
jika tidak. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
enableSorting(enableSorting)
Menetapkan apakah akan mengurutkan kolom saat pengguna mengklik judul kolom.
Jika pengurutan diaktifkan, baris akan otomatis diurutkan saat pengguna mengklik header kolom. Perilaku default-nya adalah mengaktifkan pengurutan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
enableSorting | Boolean | true untuk mengaktifkan pengurutan dengan mengklik header kolom, atau false jika tidak. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
getChartType()
getContainer()
Tampilkan diagram ContainerInfo
, yang mengenkapsulasi tempat diagram muncul pada sheet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var 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() var containerInfo = chartBuilder.getContainer(); // 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
getRanges()
Menampilkan salinan daftar rentang yang saat ini menyediakan data untuk diagram ini. Gunakan addRange(range)
dan removeRange(range)
untuk mengubah daftar ini.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0); var ranges = chartBuilder.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 diagram yang akan dibuat sebagai sumber data
removeRange(range)
Menghapus rentang yang ditentukan dari diagram yang dimodifikasi oleh builder ini. Tidak menampilkan {i>error<i} jika rentang tidak ada dalam diagram ini.
Rentang yang dihapus harus cocok dengan rentang yang ditambahkan melalui addRange(range)
;
jika tidak, tidak ada perubahan yang dilakukan pada diagram. Metode ini tidak dapat digunakan untuk menghapus sebagian nilai
dari rentang.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var firstRange = sheet.getRange("A1:B5"); var secondRange = sheet.getRange("A6:B8"); var 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")); var chart = chartBuilder.build(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang akan dihapus. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setChartType(type)
Mengubah jenis diagram. Tidak semua jenis diagram tersemat saat ini didukung. Lihat ChartType
.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
type | ChartType | Jenis untuk mengubah diagram ini. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setFirstRowNumber(number)
Menetapkan nomor baris untuk baris pertama dalam tabel data.
Nomor baris default untuk baris pertama adalah 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Integer | Nomor baris untuk baris pertama dalam tabel data. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
setHiddenDimensionStrategy(strategy)
Menetapkan strategi yang akan digunakan untuk 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(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
strategy | ChartHiddenDimensionStrategy | Strategi yang akan digunakan untuk baris dan kolom tersembunyi. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setInitialSortingAscending(column)
Menetapkan indeks kolom yang sesuai dengan tabel yang pertama kali diurutkan (menaik).
Kolom {i>os<i} diurutkan dalam urutan menaik dan ditandai dengan panah kecil yang mengindikasikan hal itu.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
column | Integer | Jumlah kolom yang digunakan untuk mengurutkan tabel pada awalnya. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
setInitialSortingDescending(column)
Menetapkan indeks kolom yang sesuai dengan tabel yang harus diurutkan pertama kali (menurun).
Kolom {i>os<i} diurutkan dalam urutan menurun dan ditandai dengan panah kecil yang mengindikasikan hal itu.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
column | Integer | Jumlah kolom yang digunakan untuk mengurutkan tabel pada awalnya. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
setMergeStrategy(mergeStrategy)
Menetapkan strategi penggabungan yang akan digunakan saat terdapat lebih dari satu rentang. Jika MERGE_ROWS
, baris 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("C:C10"); var 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 |
---|---|---|
mergeStrategy | ChartMergeStrategy | Strategi penggabungan yang akan digunakan. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setNumHeaders(headers)
Menetapkan jumlah baris atau kolom rentang yang harus 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(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
headers | Integer | Jumlah baris atau kolom yang akan diperlakukan sebagai {i>header<i}. Nilai negatif menyebabkan header terdeteksi secara otomatis. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setOption(option, value)
Menetapkan opsi lanjutan untuk diagram ini. Untuk melihat daftar opsi yang tersedia, lihat Opsi konfigurasi diagram.
Metode ini tidak memvalidasi bahwa opsi yang Anda tentukan valid untuk jenis diagram ini atau jika nilainya memiliki format/struktur yang benar.
Contoh ini menunjukkan cara mengubah judul dan menetapkan legenda.
builder.setOption('title', 'Earnings projections'); builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
option | String | Nama opsi. |
value | Object | Nilai opsi. |
Return
EmbeddedChartBuilder
— Builder ini untuk membuat rantai.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Menetapkan posisi, mengubah lokasi kemunculan diagram pada sheet. anchorRowPos
dan
anchorColPos
diindeks 1.
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
anchorRowPos | Integer | Sisi atas diagram ditambatkan di baris ini. |
anchorColPos | Integer | Sisi kiri diagram ditambatkan pada kolom ini. |
offsetX | Integer | Sudut kanan atas diagram di-offset sebanyak jumlah piksel ini. |
offsetY | Integer | Sudut kiri bawah diagram di-offset sebanyak jumlah piksel ini. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
setTransposeRowsAndColumns(transpose)
Menetapkan apakah baris dan kolom diagram ditransposisikan. Jika ditetapkan ke true
, baris dan kolom akan diganti. Nilai defaultnya adalah false
.
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) .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. |
Return
EmbeddedChartBuilder
— builder ini, untuk membuat rantai
showRowNumberColumn(showRowNumber)
Menetapkan apakah akan menampilkan nomor baris sebagai kolom pertama tabel.
Perilaku default-nya tidak menampilkan nomor baris.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
showRowNumber | Boolean | true jika kolom pertama dari tabel harus menampilkan nomor baris,
false jika tidak. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.
useAlternatingRowStyle(alternate)
Menetapkan apakah gaya warna alternatif ditetapkan ke baris ganjil dan genap pada diagram tabel.
Perilaku default adalah baris yang memiliki gaya warna alternatif.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
alternate | Boolean | true jika gaya warna harus bergantian, false jika tidak. |
Return
EmbeddedTableChartBuilder
— Builder ini berguna untuk membuat rantai.