Phương thức
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ên | Loại | 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 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()
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)
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 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ên | Loại | 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
setBackgroundColor(cssValue)
Đặt màu nền cho biểu đồ.
// Creates a line chart builder and sets the background color to gray var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
Tham số
Tên | Loại | Mô tả |
---|---|---|
cssValue | String | Giá trị CSS cho màu sắc (chẳng hạn như "blue" hoặc "#00f" ). |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc 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ên | Loại | Mô tả |
---|---|---|
type | ChartType | Loạ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
setColors(cssValues)
Đặt màu cho các đường trong biểu đồ.
// 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"]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
cssValues | String[] | Một mảng giá trị CSS màu, chẳng hạn như ["red", "#acf"] . Phần tử thứ n
trong mảng biểu thị màu của dòng thứ n trong biểu đồ. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc 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ên | Loại | 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
setLegendPosition(position)
Đặt vị trí của chú giải tương ứng với biểu đồ. Theo mặc định, không có chú giải.
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Tham số
Tên | Loại | Mô tả |
---|---|---|
position | Position | Vị trí của chú giải. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setLegendTextStyle(textStyle)
Đặt kiểu văn bản của phần chú thích biểu đồ.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho chú thích biểu đồ. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc 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ên | Loại | Mô tả |
---|---|---|
mergeStrategy | ChartMergeStrategy | Chiế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ên | Loại | Mô tả |
---|---|---|
headers | Integer | Số 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ên | Loại | Mô tả |
---|---|---|
option | String | Tên của tuỳ chọn. |
value | Object | Giá trị của lựa chọn. |
Cầu thủ trả bóng
EmbeddedChartBuilder
— Trình tạo này, để tạo chuỗi.
setPointStyle(style)
Đặt kiểu cho các điểm trong đường kẻ. Theo mặc định, các điểm không có kiểu cụ thể và chỉ dòng có thể nhìn thấy.
// Creates a line chart builder and sets large point style. var builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Tham số
Tên | Loại | Mô tả |
---|---|---|
style | PointStyle | Kiểu sử dụng cho các điểm trong đường kẻ. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
Xem thêm
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Đặt vị trí, thay đổi vị trí mà biểu đồ xuất hiện trên trang tính. anchorRowPos
và
anchorColPos
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ên | Loại | Mô tả |
---|---|---|
anchorRowPos | Integer | Phần trên cùng của biểu đồ được neo vào hàng này. |
anchorColPos | Integer | Phần bên trái của biểu đồ được neo trong cột này. |
offsetX | Integer | Góc trên bên phải của biểu đồ được bù trừ bằng số pixel này. |
offsetY | Integer | Gó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
setTitle(chartTitle)
Đặt tiêu đề của biểu đồ. Tiêu đề được hiển thị ở chính giữa phía trên biểu đồ.
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
Tham số
Tên | Loại | Mô tả |
---|---|---|
chartTitle | String | tiêu đề biểu đồ. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setTitleTextStyle(textStyle)
Đặt kiểu văn bản cho tiêu đề biểu đồ.
// 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề biểu đồ. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc 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à
các cột đã đượ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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
transpose | Boolean | Nế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
setXAxisLogScale()
Chuyển trục hoành thành thang đo logarit (yêu cầu tất cả các giá trị phải là số dương).
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisRange(start, end)
Đặt phạm vi cho trục hoành của biểu đồ.
Nếu có bất kỳ điểm dữ liệu nào nằm ngoài phạm vi, phạm vi sẽ được mở rộng để bao gồm các điểm dữ liệu đó .
// Creates a scatter chart builder and sets the X-axis range to be 0 to 100. var builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất trên trục hoành. |
end | Number | Giá trị cho đường lưới cao nhất của trục hoành. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTextStyle(textStyle)
Đặt kiểu văn bản trục hoành.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point font. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTitle(title)
Thêm tiêu đề vào trục hoành. Tiêu đề được căn giữa và xuất hiện bên dưới giá trị trục .
// Creates a line chart builder and sets the X-axis title. var builder = Charts.newLineChart(); builder.setTitle('X-axis Title')
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề cho trục X. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setXAxisTitleTextStyle(textStyle)
Đặt kiểu văn bản tiêu đề trục hoành.
// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisLogScale()
Chuyển trục tung thành thang đo logarit (yêu cầu tất cả các giá trị phải là số dương).
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisRange(start, end)
Đặt phạm vi cho trục tung của biểu đồ. Nếu có bất kỳ điểm dữ liệu nào nằm ngoài phạm vi, phạm vi sẽ được mở rộng để bao gồm các điểm dữ liệu đó.
// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100. var builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Number | Giá trị cho đường lưới thấp nhất của trục tung. |
end | Number | Giá trị cho đường lưới cao nhất của trục tung. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTextStyle(textStyle)
Đặt kiểu văn bản trục tung.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTitle(title)
Thêm tiêu đề vào trục tung. Tiêu đề được căn giữa và xuất hiện ở bên trái của giá trị .
// Creates a line chart builder and sets the Y-axis title. var builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title')
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Tiêu đề cho trục Y. |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.
setYAxisTitleTextStyle(textStyle)
Đặt kiểu văn bản tiêu đề trục tung.
// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textStyle | TextStyle | Kiểu văn bản sử dụng cho tiêu đề trục hoành. Bạn có thể tạo đối tượng TextStyleBuilder bằng cách gọi Charts.newTextStyle() . |
Cầu thủ trả bóng
EmbeddedScatterChartBuilder
– Trình tạo này, hữu ích cho việc tạo chuỗi.