Class EmbeddedTableChartBuilder

Menambahkan rentang ke diagram yang diubah builder ini. Tidak menambah rentang jika sudah yang 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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder.

Pulang pergi

EmbeddedAreaChartBuilder — builder untuk diagram area

Menetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder.

Pulang pergi

EmbeddedBarChartBuilder — builder untuk diagram batang

Menetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder.

Pulang pergi

EmbeddedColumnChartBuilder — builder untuk diagram kolom

Menetapkan jenis diagram ke ComboChart dan menampilkan EmbeddedComboChartBuilder.

Pulang pergi

EmbeddedComboChartBuilder — builder untuk diagram kombinasi

Menetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder.

Pulang pergi

EmbeddedHistogramChartBuilder — builder untuk diagram histogram

Menetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder.

Pulang pergi

EmbeddedLineChartBuilder — builder untuk diagram garis

Menetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder.

Pulang pergi

EmbeddedPieChartBuilder — builder untuk diagram lingkaran

Menetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder.

Pulang pergi

EmbeddedScatterChartBuilder — builder untuk diagram sebar

Menetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder.

Pulang pergi

EmbeddedTableChartBuilder — builder untuk diagram tabel

Membuat diagram untuk mencerminkan semua perubahan yang dilakukan pada diagram tersebut.

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

Pulang pergi

EmbeddedChart — diagram yang dibuat, yang masih harus ditambahkan ke spreadsheet

Menghapus semua rentang dari diagram yang diubah 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);

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan apakah akan mengaktifkan paging melalui data.

Perilaku defaultnya adalah paging dinonaktifkan. Jika paging diaktifkan, ukuran halaman default adalah 10.

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

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

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Mengaktifkan paging, menetapkan jumlah baris di setiap halaman dan halaman tabel pertama yang akan ditampilkan (halaman angkanya 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

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menambahkan dukungan dasar untuk bahasa yang ditulis dari kanan ke kiri (seperti bahasa Arab atau Ibrani) dengan membalikkan urutan kolom tabel, sehingga kolom nol adalah kolom paling kanan, dan kolom terakhir adalah kolom paling kiri.

Hal ini hanya memengaruhi urutan tampilan, bukan indeks kolom pada data pokok. Tampilan bahasa dua arah penuh (BiDi) tidak didukung oleh visualisasi tabel, bahkan dengan opsi ini. Opsi ini diabaikan jika Anda mengaktifkan paging (menggunakan opsi halaman), atau jika tabel memiliki bilah gulir karena Anda telah menetapkan opsi tinggi dan lebar yang lebih kecil dari ukuran tabel yang diperlukan. Perilaku defaultnya adalah dukungan RTL dinonaktifkan.

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menetapkan apakah akan mengurutkan kolom saat pengguna mengklik judul kolom.

Jika pengurutan diaktifkan, baris akan otomatis ditampilkan saat pengguna mengklik header kolom diurutkan. Perilaku defaultnya adalah penyortiran diaktifkan.

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menampilkan jenis diagram saat ini.

Pulang pergi

ChartType — jenis diagram

Tampilkan diagram ContainerInfo, yang merangkum tempat diagram muncul di {i>sheet<i}.

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

Pulang pergi

ContainerInfo — objek yang berisi posisi penampung diagram

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

Pulang pergi

Range[] — array rentang yang berfungsi sebagai sumber data yang akan dibuat

Menghapus rentang yang ditentukan dari diagram yang diubah builder ini. Tidak menampilkan error jika rentangnya 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 bagan. Metode ini tidak dapat digunakan untuk menghapus sebagian nilai dari suatu 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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

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

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menetapkan strategi yang akan digunakan untuk 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();

sheet.insertChart(chart);

Parameter

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan indeks kolom berdasarkan tabel yang harus diurutkan terlebih dahulu (menaik).

Kolom os diurutkan dalam urutan menaik dan ditandai dengan panah kecil yang menunjukkan hal tersebut.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menetapkan indeks kolom berdasarkan tabel yang harus diurutkan terlebih dahulu (menurun).

Kolom os diurutkan dalam urutan menurun dan ditandai dengan panah kecil yang menunjukkan hal tersebut.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menetapkan strategi penggabungan yang akan digunakan saat 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("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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan opsi lanjutan untuk diagram ini. Untuk melihat daftar opsi yang tersedia, lihat Bagan opsi konfigurasi.

Metode ini tidak memvalidasi opsi yang Anda tentukan valid untuk jenis diagram ini atau jika 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

Pulang pergi

EmbeddedChartBuilder — Builder ini, untuk perantaian.

Menetapkan posisi, mengubah tempat diagram muncul pada sheet. anchorRowPos dan anchorColPos diindeks dengan 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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan apakah baris dan kolom diagram ditransposisikan. Jika ditetapkan ke true, baris dan dan kolom diubah. 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

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian

Menetapkan apakah nomor baris akan ditampilkan sebagai kolom pertama tabel.

Perilaku default-nya adalah tidak menampilkan nomor baris.

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.

Menetapkan apakah gaya warna alternatif ditetapkan untuk baris ganjil dan genap pada diagram tabel.

Perilaku default-nya adalah baris yang memiliki gaya warna alternatif.

Parameter

Pulang pergi

EmbeddedTableChartBuilder — Builder ini, berguna untuk perantaian.