Trình tạo được dùng để chỉnh sửa EmbeddedChart. Các thay đổi đối với biểu đồ không được lưu cho đến khi 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ức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
addRange(range) | EmbeddedChartBuilder | Thê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 Biểu đồ vùng và trả về 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ành ColumnChart và trả về một EmbeddedColumnChartBuilder. |
asComboChart() | EmbeddedComboChartBuilder | Đặt loại biểu đồ thành CompChart và trả về một 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() | EmbeddedChart | Tạo biểu đồ để phản ánh tất cả thay đổi đã thực hiện cho biểu đồ. |
clearRanges() | EmbeddedChartBuilder | Xoá tất cả dải ô khỏi biểu đồ mà trình tạo này sửa đổi. |
getChartType() | ChartType | Trả về loại biểu đồ hiện tại. |
getContainer() | ContainerInfo | Trả về biểu đồ ContainerInfo bao gồm 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) | EmbeddedChartBuilder | Xoá dải ô được chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. |
setChartType(type) | EmbeddedChartBuilder | Thay đổi loại biểu đồ. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | Thiết lập 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 tồn tại nhiều dải ô. |
setNumHeaders(headers) | EmbeddedChartBuilder | Đặt số 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 | Thiết lập vị trí, thay đổi vị trí biểu đồ xuất hiện trên trang tính. |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | Thiết lập 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 thêm 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
range | Range | Dả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 Biểu đồ vùng và trả về EmbeddedAreaChartBuilder.
Cầu thủ trả bóng
EmbeddedAreaChartBuilder — 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ành ColumnChart 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 CompChart và trả về một EmbeddedComboChartBuilder.
Cầu thủ trả bóng
EmbeddedComboChartBuilder — 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 đồ biểu đồ
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 — trình tạo 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 — 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 — trình tạo biểu đồ bảng
build()
Tạo biểu đồ để phản ánh tất cả thay đổi đã thực hiện cho biểu đồ.
Phương thức này không tự động vẽ biểu đồ lên trên bảng tính. Bạn phải chèn một biểu đồ mới qua sheet.insertChart(chart) và cập nhật biểu đồ hiện có 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()
getContainer()
Trả về biểu đồ ContainerInfo bao gồm 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) và 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 các dải ô đóng vai trò là biểu đồ nguồn dữ liệu được tạo
removeRange(range)
Xoá dải ô được chỉ định khỏi biểu đồ mà trình tạo này sửa đổi. Hệ thống sẽ 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 một dải ô được thêm qua addRange(range); nếu không, biểu đồ sẽ không có gì thay đổi. Không thể dùng phương thức này để xoá một phần các giá trị khỏi 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
range | Range | Dả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 đồ. Hiện tại, chưa phải tất cả các loại biểu đồ đã nhúng đều được hỗ trợ. 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
type | ChartType | Loại thay đổi biểu đồ này. |
Cầu thủ trả bóng
EmbeddedChartBuilder — trình tạo này để tạo chuỗi
setHiddenDimensionStrategy(strategy)
Thiết lập 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
strategy | ChartHiddenDimensionStrategy | Chiế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 tồn tại nhiều dải ô. Nếu là MERGE_ROWS, các hàng sẽ được hợp nhất; nếu là 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
mergeStrategy | ChartMergeStrategy | Chiến lược hợp nhất để sử dụng. |
Cầu thủ trả bóng
EmbeddedChartBuilder — trình tạo này để tạo chuỗi
setNumHeaders(headers)
Đặt số 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
headers | Integer | Số hàng hoặc cột được coi là tiêu đề. Giá trị âm khiến hệ thống tự động phát hiện tiêu đề. |
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 tuỳ chọn có sẵn, hãy xem bài viết Tuỳ chọn cấu hình biểu đồ.
Phương thức này không xác thực tuỳ chọn mà bạn chỉ định là hợp lệ cho loại biểu đồ này, cũng như không xác thực nếu giá trị 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}});
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
option | String | Tên của tuỳ chọn. |
value | Object | Giá trị của tuỳ chọn. |
Cầu thủ trả bóng
EmbeddedChartBuilder – Trình tạo này để tạo chuỗi.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Thiết lập vị trí, thay đổi vị trí biểu đồ xuất hiện trên trang tính. anchorRowPos và anchorColPos được lập chỉ mục 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
anchorRowPos | Integer | Phía trên cùng của biểu đồ được neo vào hàng này. |
anchorColPos | Integer | Phía bên trái của biểu đồ được neo vào cột này. |
offsetX | Integer | Góc trên bên phải của biểu đồ được bù đắp bằng nhiều pixel. |
offsetY | Integer | Góc dưới bên trái của biểu đồ được bù đắp bằng nhiều pixel này. |
Cầu thủ trả bóng
EmbeddedChartBuilder — trình tạo này để tạo chuỗi
setTransposeRowsAndColumns(transpose)
Thiết lập 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 thành true, các hàng và cột sẽ được chuyển đổi. 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);
Các tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
transpose | Boolean | Nếu là true, các hàng và cột dùng để tạo biểu đồ sẽ được hoán vị. |
Cầu thủ trả bóng
EmbeddedChartBuilder — trình tạo này để tạo chuỗi