Class EmbeddedChartBuilder

Trìnhtạobiểuđồđược nhúng

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B8');
let 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ứcKiểu 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ành ColumnChart và trả về một EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderĐặt loại biểu đồ thành ComboChart 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()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ả cá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ề ContainerInfo biểu đồ, trong đó gói gọn 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 ô đã 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 ô.
setNumHeaders(headers)EmbeddedChartBuilderĐặt số hàng hoặc cột của dải ô cần được coi là tiêu đề.
setOption(option, value)EmbeddedChartBuilderĐặt các lựa chọn nâng cao cho biểu đồ này.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderĐặt vị trí, thay đổi vị trí xuất hiện của biểu đồ trên trang tính.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderĐặt xem các hàng và cột của biểu đồ có được chuyể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 đồ. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

asAreaChart()

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

Cầu thủ trả bóng

EmbeddedAreaChartBuilder – Trình tạo cho 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 cho biểu đồ dạng 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 cho biểu đồ cột.

asComboChart()

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

Cầu thủ trả bóng

EmbeddedComboChartBuilder – Trình tạo cho 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 cho 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 cho 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 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 – Trình tạo cho biểu đồ phân tán.

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 cho biểu đồ dạng 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 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 biểu đồ mới thông qua sheet.insertChart(chart) và cập nhật biểu đồ hiện có thông qua sheet.updateChart(chart). 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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ẫn phải được thêm vào bảng tính.

clearRanges()

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the
// existing formatting of the chart.
const chart = sheet.getCharts()[0];
const 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, để liên kết.

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ề ContainerInfo biểu đồ, trong đó gói gọn vị trí biểu đồ xuất hiện trên trang tính. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const 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()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(sheet.getRange('A1:B8'))
                         .setPosition(5, 5, 0, 0);

const ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const 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à nguồn dữ liệu của biểu đồ cần tạo.

removeRange(range)

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

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(firstRange)
                         // This range renders 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
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

setChartType(type)

Thay đổi loại biểu đồ. Hiện tại, một số loại biểu đồ được nhúng không được hỗ trợ. Vui lòng xem ChartType. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông số

TênLoạiMô tả
typeChartTypeLoại biểu đồ mà bạn muốn chuyển đổi.

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

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. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setHiddenDimensionStrategy(
                      Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS,
                      )
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông 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, để liên kết.

setMergeStrategy(mergeStrategy)

Đặt chiến lược hợp nhất để sử dụng khi có nhiều dải ô. Nếu 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. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C:C10');
const 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);

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

setNumHeaders(headers)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setNumHeaders(1)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông số

TênLoạiMô tả
headersIntegerSố lượng hàng hoặc cột được coi 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, để liên kết.

setOption(option, value)

Đặt các lựa chọn nâng cao cho biểu đồ này. Để xem danh sách các lựa chọn có sẵn, hãy xem phần Các lựa chọn về cấu hình biểu đồ.

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

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

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Đặt vị trí, thay đổi vị trí xuất hiện của biểu đồ trên trang tính. anchorRowPos và anchorColPos được lập chỉ mục từ 1. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.

setTransposeRowsAndColumns(transpose)

Đặt xem các hàng và cột của biểu đồ có được chuyển vị hay không. Nếu được đặt thành true, các hàng và cột sẽ được chuyển đổi. Giá trị mặc định là false. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setTransposeRowsAndColumns(true)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Thông số

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

Cầu thủ trả bóng

EmbeddedChartBuilder – Trình tạo này, để liên kết.