Class EmbeddedChartBuilder

EmbeddedChartBuilder

Trình tạo dùng để chỉnh sửa EmbeddedChart. Các thay đổi đối với biểu đồ không được lưu cho đến Sheet.updateChart(chart) được gọi trên biểu đồ tạo lại.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addRange(range)EmbeddedChartBuilderThêm một dải ô vào biểu đồ mà trình tạo này sửa đổi.
asAreaChart()EmbeddedAreaChartBuilderĐặt loại biểu đồ thành AreaChart và trả về một EmbeddedAreaChartBuilder.
asBarChart()EmbeddedBarChartBuilderĐặt loại biểu đồ thành BarChart và trả về một EmbeddedBarChartBuilder.
asColumnChart()EmbeddedColumnChartBuilderĐặt loại biểu đồ thànhColumnChart và trả về một EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderĐặt loại biểu đồ thành Kết hợp và trả về EmbeddedComboChartBuilder.
asHistogramChart()EmbeddedHistogramChartBuilderĐặt loại biểu đồ thành HistogramChart và trả về một EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderĐặt loại biểu đồ thành LineChart và trả về một EmbeddedLineChartBuilder.
asPieChart()EmbeddedPieChartBuilderĐặt loại biểu đồ thành PieChart và trả về một EmbeddedPieChartBuilder.
asScatterChart()EmbeddedScatterChartBuilderĐặt loại biểu đồ thành ScatterChart và trả về một EmbeddedScatterChartBuilder.
asTableChart()EmbeddedTableChartBuilderĐặt loại biểu đồ thành TableChart và trả về một EmbeddedTableChartBuilder.
build()EmbeddedChartTạo biểu đồ để phản ánh tất cả các thay đổi đã thực hiện đối với biểu đồ đó.
clearRanges()EmbeddedChartBuilderXoá tất cả dải ô khỏi biểu đồ mà trình tạo này sửa đổi.
getChartType()ChartTypeTrả về loại biểu đồ hiện tại.
getContainer()ContainerInfoTrả về biểu đồ ContainerInfo, biểu đồ này đóng gói vị trí biểu đồ xuất hiện trên trang tính.
getRanges()Range[]Trả về bản sao của danh sách các dải ô hiện đang cung cấp dữ liệu cho biểu đồ này.
removeRange(range)EmbeddedChartBuilderXoá dải ô được chỉ định khỏi biểu đồ mà trình tạo này sửa đổi.
setChartType(type)EmbeddedChartBuilderThay đổi loại biểu đồ.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderĐặt chiến lược để sử dụng cho các hàng và cột bị ẩn.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderĐặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô tồn tại.
setNumHeaders(headers)EmbeddedChartBuilderĐặt số lượng hàng hoặc cột của dải ô được coi là tiêu đề.
setOption(option, value)EmbeddedChartBuilderĐặt các tuỳ chọn nâng cao cho biểu đồ này.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderĐặt vị trí, thay đổi vị trí mà biểu đồ xuất hiện trên trang tính.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderĐặt xem các hàng và cột của biểu đồ có được hoán vị hay không.

Tài liệu chi tiết

addRange(range)

Thêm một dải ô vào biểu đồ mà trình tạo này sửa đổi. Không thêm dải ô nếu dải ô đã được vào biểu đồ.

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

Tham số

TênLoạiMô tả
rangeRangeDải ô cần thêm.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


asAreaChart()

Đặt loại biểu đồ thành AreaChart và trả về một EmbeddedAreaChartBuilder.

Cầu thủ trả bóng

EmbeddedAreaChartBuilder – một trình tạo biểu đồ vùng


asBarChart()

Đặt loại biểu đồ thành BarChart và trả về một EmbeddedBarChartBuilder.

Cầu thủ trả bóng

EmbeddedBarChartBuilder – trình tạo biểu đồ thanh


asColumnChart()

Đặt loại biểu đồ thànhColumnChart và trả về một EmbeddedColumnChartBuilder.

Cầu thủ trả bóng

EmbeddedColumnChartBuilder – trình tạo biểu đồ cột


asComboChart()

Đặt loại biểu đồ thành Kết hợp và trả về EmbeddedComboChartBuilder.

Cầu thủ trả bóng

EmbeddedComboChartBuilder – một trình tạo biểu đồ kết hợp


asHistogramChart()

Đặt loại biểu đồ thành HistogramChart và trả về một EmbeddedHistogramChartBuilder.

Cầu thủ trả bóng

EmbeddedHistogramChartBuilder – trình tạo biểu đồ tần suất


asLineChart()

Đặt loại biểu đồ thành LineChart và trả về một EmbeddedLineChartBuilder.

Cầu thủ trả bóng

EmbeddedLineChartBuilder – trình tạo biểu đồ dạng đường


asPieChart()

Đặt loại biểu đồ thành PieChart và trả về một EmbeddedPieChartBuilder.

Cầu thủ trả bóng

EmbeddedPieChartBuilder – một trình tạo cho biểu đồ hình tròn


asScatterChart()

Đặt loại biểu đồ thành ScatterChart và trả về một EmbeddedScatterChartBuilder.

Cầu thủ trả bóng

EmbeddedScatterChartBuilder — một trình tạo biểu đồ tán xạ


asTableChart()

Đặt loại biểu đồ thành TableChart và trả về một EmbeddedTableChartBuilder.

Cầu thủ trả bóng

EmbeddedTableChartBuilder – một trình tạo cho biểu đồ bảng


build()

Tạo biểu đồ để phản ánh tất cả các thay đổi đã thực hiện đối với biểu đồ đó.

Phương pháp này không tự động vẽ biểu đồ ở đầu bảng tính. Một biểu đồ mới phải được chèn qua sheet.insertChart(chart) và phải cập nhật biểu đồ hiện có thông qua 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);

Cầu thủ trả bóng

EmbeddedChart — biểu đồ đã tạo và vẫn phải được thêm vào bảng tính


clearRanges()

Xoá tất cả dải ô khỏi biểu đồ mà trình tạo này sửa đổi.

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

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


getChartType()

Trả về loại biểu đồ hiện tại.

Cầu thủ trả bóng

ChartType – loại biểu đồ


getContainer()

Trả về biểu đồ ContainerInfo, biểu đồ này đóng gói vị trí biểu đồ xuất hiện trên trang tính.

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

Cầu thủ trả bóng

ContainerInfo – một đối tượng chứa vị trí của vùng chứa biểu đồ


getRanges()

Trả về bản sao của danh sách các dải ô hiện đang cung cấp dữ liệu cho biểu đồ này. Sử dụng addRange(range)removeRange(range) để sửa đổi danh sách này.

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

Cầu thủ trả bóng

Range[] – một mảng dải ô đóng vai trò là biểu đồ sẽ được dùng để tạo nguồn dữ liệu


removeRange(range)

Xoá dải ô được chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. Không gửi lỗi nếu dải ô không nằm trong biểu đồ này.

Dải ô bị xoá phải khớp với dải ô được thêm qua addRange(range); nếu không thì sẽ không có thay đổi nào đối với biểu đồ. Không thể dùng phương thức này để xoá một phần giá trị từ một dải ô.

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

Tham số

TênLoạiMô tả
rangeRangeDải ô cần xoá.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setChartType(type)

Thay đổi loại biểu đồ. Google chưa hỗ trợ một số loại biểu đồ được nhúng. Vui lòng xem 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);

Tham số

TênLoạiMô tả
typeChartTypeLoại để chuyển biểu đồ này thành.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setHiddenDimensionStrategy(strategy)

Đặt chiến lược để sử dụng cho các hàng và cột bị ẩn. Giá trị mặc định là 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);

Tham số

TênLoạiMô tả
strategyChartHiddenDimensionStrategyChiến lược sử dụng cho các hàng và cột bị ẩn.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setMergeStrategy(mergeStrategy)

Đặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô tồn tại. Nếu giá trị là MERGE_ROWS, các hàng sẽ được hợp nhất; nếu MERGE_COLUMNS, các cột sẽ được hợp nhất. Mặc định là 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);

Tham số

TênLoạiMô tả
mergeStrategyChartMergeStrategyChiến lược hợp nhất sẽ sử dụng.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setNumHeaders(headers)

Đặt số lượng hàng hoặc cột của dải ô được coi là tiêu đề.

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

Tham số

TênLoạiMô tả
headersIntegerSố hàng hoặc cột được xem là tiêu đề. Giá trị âm khiến tiêu đề để được tự động phát hiện.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setOption(option, value)

Đặt các tuỳ chọn nâng cao cho biểu đồ này. Để xem danh sách các lựa chọn hiện có, hãy xem phần Biểu đồ các tùy chọn cấu hình.

Phương thức này không xác thực lựa chọn mà bạn chỉ định là hợp lệ cho loại biểu đồ này hoặc nếu có định dạng/cấu trúc chính xác.

Ví dụ này cho biết cách thay đổi tiêu đề và đặt chú giải.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Tham số

TênLoạiMô tả
optionStringTên của tuỳ chọn.
valueObjectGiá trị của lựa chọn.

Cầu thủ trả bóng

EmbeddedChartBuilder — Trình tạo này, để tạo chuỗi.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Đặt vị trí, thay đổi vị trí mà biểu đồ xuất hiện trên trang tính. anchorRowPosanchorColPos có 1 chỉ mục.

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

Tham số

TênLoạiMô tả
anchorRowPosIntegerPhần trên cùng của biểu đồ được neo vào hàng này.
anchorColPosIntegerPhần bên trái của biểu đồ được neo trong cột này.
offsetXIntegerGóc trên bên phải của biểu đồ được bù trừ bằng số pixel này.
offsetYIntegerGóc dưới bên trái của biểu đồ được bù trừ bằng số pixel này.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi


setTransposeRowsAndColumns(transpose)

Đặt xem các hàng và cột của biểu đồ có được hoán vị hay không. Nếu bạn đặt chính sách này thành true, các hàng và chuyển đổi giữa các cột. Giá trị mặc định là 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);

Tham số

TênLoạiMô tả
transposeBooleanNếu giá trị là true, các hàng và cột dùng để tạo biểu đồ sẽ là hoán vị.

Cầu thủ trả bóng

EmbeddedChartBuilder – trình tạo này, để tạo chuỗi