Class EmbeddedPieChartBuilder

EmbeddedPieChartBuilder

Builder untuk diagram lingkaran. Untuk detail lebih lanjut, lihat Gviz dokumentasi tambahan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addRange(range)EmbeddedChartBuilderMenambahkan rentang ke diagram yang diubah builder ini.
asAreaChart()EmbeddedAreaChartBuilderMenetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder.
asBarChart()EmbeddedBarChartBuilderMenetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder.
asColumnChart()EmbeddedColumnChartBuilderMenetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderMenetapkan jenis diagram ke ComboChart dan menampilkan EmbeddedComboChartBuilder.
asHistogramChart()EmbeddedHistogramChartBuilderMenetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderMenetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder.
asPieChart()EmbeddedPieChartBuilderMenetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder.
asScatterChart()EmbeddedScatterChartBuilderMenetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder.
asTableChart()EmbeddedTableChartBuilderMenetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder.
build()EmbeddedChartMembuat diagram untuk mencerminkan semua perubahan yang dilakukan pada diagram tersebut.
clearRanges()EmbeddedChartBuilderMenghapus semua rentang dari diagram yang diubah builder ini.
getChartType()ChartTypeMenampilkan jenis diagram saat ini.
getContainer()ContainerInfoTampilkan diagram ContainerInfo, yang merangkum tempat diagram muncul di {i>sheet<i}.
getRanges()Range[]Menampilkan salinan daftar rentang yang saat ini menyediakan data untuk diagram ini.
removeRange(range)EmbeddedChartBuilderMenghapus rentang yang ditentukan dari diagram yang diubah builder ini.
reverseCategories()EmbeddedPieChartBuilderMembalikkan gambar deret dalam sumbu domain.
set3D()EmbeddedPieChartBuilderMenetapkan diagram ke tiga dimensi.
setBackgroundColor(cssValue)EmbeddedPieChartBuilderMenetapkan warna latar belakang untuk diagram.
setChartType(type)EmbeddedChartBuilderMengubah jenis diagram.
setColors(cssValues)EmbeddedPieChartBuilderMenetapkan warna untuk garis dalam diagram.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderMenetapkan strategi yang akan digunakan untuk baris dan kolom yang tersembunyi.
setLegendPosition(position)EmbeddedPieChartBuilderMenetapkan posisi legenda terhadap diagram.
setLegendTextStyle(textStyle)EmbeddedPieChartBuilderMenetapkan gaya teks legenda diagram.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderMenetapkan strategi penggabungan yang akan digunakan saat ada lebih dari satu rentang.
setNumHeaders(headers)EmbeddedChartBuilderMenetapkan jumlah baris atau kolom rentang yang harus diperlakukan sebagai header.
setOption(option, value)EmbeddedChartBuilderMenetapkan opsi lanjutan untuk diagram ini.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderMenetapkan posisi, mengubah tempat diagram muncul pada sheet.
setTitle(chartTitle)EmbeddedPieChartBuilderMenetapkan judul diagram.
setTitleTextStyle(textStyle)EmbeddedPieChartBuilderMenetapkan gaya teks judul diagram.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderMenetapkan apakah baris dan kolom diagram ditransposisikan.

Dokumentasi mendetail

addRange(range)

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

NamaJenisDeskripsi
rangeRangeRentang yang akan ditambahkan.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


asAreaChart()

Menetapkan jenis diagram ke AreaChart dan menampilkan EmbeddedAreaChartBuilder.

Pulang pergi

EmbeddedAreaChartBuilder — builder untuk diagram area


asBarChart()

Menetapkan jenis diagram ke BarChart dan menampilkan EmbeddedBarChartBuilder.

Pulang pergi

EmbeddedBarChartBuilder — builder untuk diagram batang


asColumnChart()

Menetapkan jenis diagram ke ColumnChart dan menampilkan EmbeddedColumnChartBuilder.

Pulang pergi

EmbeddedColumnChartBuilder — builder untuk diagram kolom


asComboChart()

Menetapkan jenis diagram ke ComboChart dan menampilkan EmbeddedComboChartBuilder.

Pulang pergi

EmbeddedComboChartBuilder — builder untuk diagram kombinasi


asHistogramChart()

Menetapkan jenis diagram ke HistogramChart dan menampilkan EmbeddedHistogramChartBuilder.

Pulang pergi

EmbeddedHistogramChartBuilder — builder untuk diagram histogram


asLineChart()

Menetapkan jenis diagram ke LineChart dan menampilkan EmbeddedLineChartBuilder.

Pulang pergi

EmbeddedLineChartBuilder — builder untuk diagram garis


asPieChart()

Menetapkan jenis diagram ke PieChart dan menampilkan EmbeddedPieChartBuilder.

Pulang pergi

EmbeddedPieChartBuilder — builder untuk diagram lingkaran


asScatterChart()

Menetapkan jenis diagram ke ScatterChart dan menampilkan EmbeddedScatterChartBuilder.

Pulang pergi

EmbeddedScatterChartBuilder — builder untuk diagram sebar


asTableChart()

Menetapkan jenis diagram ke TableChart dan menampilkan EmbeddedTableChartBuilder.

Pulang pergi

EmbeddedTableChartBuilder — builder untuk diagram tabel


build()

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


clearRanges()

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


getChartType()

Menampilkan jenis diagram saat ini.

Pulang pergi

ChartType — jenis diagram


getContainer()

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


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

Pulang pergi

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


removeRange(range)

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

NamaJenisDeskripsi
rangeRangeRentang yang akan dihapus.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


reverseCategories()

Membalikkan gambar deret dalam sumbu domain. Untuk diagram rentang vertikal (seperti garis, diagram area atau kolom), ini berarti sumbu horizontal digambar dari kanan ke kiri. Sebagai diagram rentang horizontal (seperti diagram batang), ini berarti sumbu vertikal digambar dari atas ke 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();

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


set3D()

Menetapkan diagram ke tiga dimensi.

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setBackgroundColor(cssValue)

Menetapkan warna latar belakang untuk diagram.

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

Parameter

NamaJenisDeskripsi
cssValueStringNilai CSS untuk warna (seperti "blue" atau "#00f").

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


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

NamaJenisDeskripsi
typeChartTypeJenis untuk mengubah diagram ini.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


setColors(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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parameter

NamaJenisDeskripsi
cssValuesString[]Array nilai CSS warna, seperti ["red", "#acf"]. Elemen ke-n dalam array mewakili warna baris ke-n dalam diagram.

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setHiddenDimensionStrategy(strategy)

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

NamaJenisDeskripsi
strategyChartHiddenDimensionStrategyStrategi yang digunakan untuk baris dan kolom tersembunyi.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


setLegendPosition(position)

Menetapkan posisi legenda terhadap 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

NamaJenisDeskripsi
positionPositionPosisi legenda.

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setLegendTextStyle(textStyle)

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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk legenda diagram.

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setMergeStrategy(mergeStrategy)

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

NamaJenisDeskripsi
mergeStrategyChartMergeStrategyStrategi penggabungan yang akan digunakan.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


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

NamaJenisDeskripsi
headersIntegerJumlah baris atau kolom yang akan diperlakukan sebagai {i>header<i}. Nilai negatif menyebabkan header terdeteksi secara otomatis.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


setOption(option, value)

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

NamaJenisDeskripsi
optionStringNama opsi.
valueObjectNilai opsi.

Pulang pergi

EmbeddedChartBuilder — Builder ini, untuk perantaian.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

NamaJenisDeskripsi
anchorRowPosIntegerSisi atas diagram ditambatkan di baris ini.
anchorColPosIntegerSisi kiri diagram ditambatkan di kolom ini.
offsetXIntegerSudut kanan atas diagram di-offset dengan piksel sebanyak ini.
offsetYIntegerSudut kiri bawah diagram di-offset dengan piksel sebanyak ini.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian


setTitle(chartTitle)

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

NamaJenisDeskripsi
chartTitleStringjudul bagan.

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setTitleTextStyle(textStyle)

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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul diagram. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

EmbeddedPieChartBuilder — Builder ini, berguna untuk perantaian.


setTransposeRowsAndColumns(transpose)

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

NamaJenisDeskripsi
transposeBooleanJika true, baris dan kolom yang digunakan untuk membuat diagram adalah ditransposisikan.

Pulang pergi

EmbeddedChartBuilder — builder ini, untuk perantaian