Class EmbeddedPieChartBuilder

Menambahkan rentang ke diagram yang dimodifikasi builder ini. Tidak menambahkan rentang jika telah 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Menetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder.

Return

EmbeddedAreaChartBuilder — builder untuk diagram area

Menetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder.

Return

EmbeddedBarChartBuilder — builder untuk diagram batang

Menetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder.

Return

EmbeddedColumnChartBuilder — builder untuk diagram kolom

Menetapkan jenis diagram ke ComboChart dan menampilkan EmbeddedComboChartBuilder.

Return

EmbeddedComboChartBuilder — builder untuk diagram kombinasi

Menetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder.

Return

EmbeddedHistogramChartBuilder — builder untuk diagram histogram

Menetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder.

Return

EmbeddedLineChartBuilder — builder untuk diagram garis

Menetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder.

Return

EmbeddedPieChartBuilder — builder untuk diagram lingkaran

Menetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder.

Return

EmbeddedScatterChartBuilder — builder untuk diagram sebar

Menetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder.

Return

EmbeddedTableChartBuilder — builder untuk diagram tabel

Membuat diagram untuk mencerminkan semua perubahan yang dibuat pada diagram.

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

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 masih harus ditambahkan ke spreadsheet

Menghapus semua rentang dari diagram yang dimodifikasi 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 rantai

Menampilkan jenis diagram saat ini.

Return

ChartType — jenis diagram

Tampilkan diagram ContainerInfo, yang mengenkapsulasi tempat diagram muncul di 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

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 sumber data

Menghapus rentang yang ditentukan dari diagram yang dimodifikasi builder ini. Tidak menampilkan error jika rentang tidak berada dalam diagram ini.

Rentang yang dihapus harus cocok dengan rentang yang ditambahkan melalui addRange(range); jika tidak, tidak ada perubahan yang akan 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Membalik gambar seri 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.
var builder = Charts.newPieChart();
builder.reverseCategories();

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan diagram menjadi tiga dimensi.

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan warna latar belakang diagram.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Mengubah jenis diagram. Tidak semua jenis diagram sematan 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Menetapkan warna garis pada diagram.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Menetapkan posisi legenda sehubungan dengan diagram. Secara default, tidak ada legenda.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan gaya teks legenda diagram.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan strategi penggabungan untuk digunakan saat ada 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Menetapkan jumlah baris atau kolom dalam 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

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

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

Return

EmbeddedChartBuilder — Builder ini, untuk rantai.

Menetapkan posisi, mengubah posisi diagram di 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

Return

EmbeddedChartBuilder — builder ini, untuk rantai

Menetapkan judul diagram. Judul ditampilkan di tengah diagram.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan gaya teks judul diagram.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parameter

Return

EmbeddedPieChartBuilder — Builder ini berguna untuk pembuatan rantai.

Menetapkan apakah baris dan kolom diagram diubah? Jika ditetapkan ke true, baris dan kolom 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()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parameter

Return

EmbeddedChartBuilder — builder ini, untuk rantai