Trang này được dịch bởi Cloud Translation API.

Class EmbeddedChart

Biểu thị một biểu đồ đã được nhúng vào bảng tính.

Ví dụ này cho thấy cách sửa đổi một biểu đồ hiện có:

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2: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);

Ví dụ này cho thấy cách tạo một biểu đồ mới:

function newChart(range) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`asDataSourceChart()`	`DataSourceChart`	Truyền đến một thực thể biểu đồ nguồn dữ liệu nếu biểu đồ là biểu đồ nguồn dữ liệu, hoặc `null` nếu không.
`getAs(contentType)`	`Blob`	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định.
`getBlob()`	`Blob`	Trả về dữ liệu bên trong đối tượng này dưới dạng blob.
`getChartId()`	`Integer`	Trả về một giá trị nhận dạng ổn định cho biểu đồ duy nhất trên bảng tính chứa biểu đồ hoặc `null` nếu biểu đồ không nằm trong bảng tính.
`getContainerInfo()`	`ContainerInfo`	Trả về thông tin về vị trí của biểu đồ trong một trang tính.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Trả về chiến lược cần sử dụng để xử lý các hàng và cột ẩn.
`getMergeStrategy()`	`ChartMergeStrategy`	Trả về chiến lược hợp nhất được sử dụng khi có nhiều dải ô.
`getNumHeaders()`	`Integer`	Trả về số hàng hoặc cột trong dải ô được coi là tiêu đề.
`getOptions()`	`ChartOptions`	Trả về các tuỳ chọn cho biểu đồ này, chẳng hạn như chiều cao, màu sắc và trục.
`getRanges()`	`Range[]`	Trả về các dải ô mà biểu đồ này sử dụng làm nguồn dữ liệu.
`getTransposeRowsAndColumns()`	`Boolean`	Nếu là `true`, các hàng và cột dùng để điền sẵn biểu đồ sẽ được chuyển đổi.
`modify()`	`EmbeddedChartBuilder`	Trả về một `EmbeddedChartBuilder` có thể dùng để sửa đổi biểu đồ này.

Tài liệu chi tiết

`asDataSourceChart()`

Truyền đến một thực thể biểu đồ nguồn dữ liệu nếu biểu đồ là biểu đồ nguồn dữ liệu, hoặc null nếu không.

Cầu thủ trả bóng

DataSourceChart – Biểu đồ nguồn dữ liệu.

`getAs(contentType)`

Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ trở thành "ShoppingList.12.25.pdf".

Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem bài viết Hạn mức cho Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân theo hạn mức nghiêm ngặt hơn.

Tham số

Tên	Loại	Mô tả
`contentType`	`String`	Loại MIME cần chuyển đổi sang. Đối với hầu hết các blob, `'application/pdf'` là tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hoặc `'image/png'` nào cũng đều hợp lệ. Đối với tài liệu Google Tài liệu, `'text/markdown'` cũng hợp lệ.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng blob.

`getBlob()`

Trả về dữ liệu bên trong đối tượng này dưới dạng blob.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng blob.

`getChartId()`

Trả về một giá trị nhận dạng ổn định cho biểu đồ duy nhất trên bảng tính chứa biểu đồ hoặc null nếu biểu đồ không nằm trong bảng tính.

Cầu thủ trả bóng

Integer – Giá trị nhận dạng biểu đồ ổn định.

`getContainerInfo()`

Trả về thông tin về vị trí của biểu đồ trong một trang tính.

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

const containerInfo = chart.getContainerInfo();

// 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 đồ

`getHiddenDimensionStrategy()`

Trả về chiến lược cần sử dụng để xử lý các hàng và cột ẩ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();

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

Cầu thủ trả bóng

ChartHiddenDimensionStrategy – Chiến lược sử dụng cho các hàng và cột ẩn.

`getMergeStrategy()`

Trả về chiến lược hợp nhất được sử dụng khi có nhiều dải ô. Nếu là MERGE_ROWS, hàng sẽ được hợp nhất; nếu là MERGE_COLUMNS, 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('C1:C10');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .addRange(range2)
                  .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this
// case.
Logger.log(chart.getMergeStrategy());

Cầu thủ trả bóng

ChartMergeStrategy – MERGE_ROWS nếu các hàng được hợp nhất trên nhiều phạm vi; MERGE_COLUMNS nếu các cột được hợp nhất trên nhiều phạm vi

`getNumHeaders()`

Trả về số hàng hoặc cột trong dải ô đượ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();

// Logs the number of rows or columns to use as headers, which is 1 in this
// case.
Logger.log(chart.getHeaders());

Cầu thủ trả bóng

Integer – Số hàng hoặc cột được coi là tiêu đề. Giá trị âm cho biết tiêu đề được tự động phát hiện.

`getOptions()`

Trả về các tuỳ chọn cho biểu đồ này, chẳng hạn như chiều cao, màu sắc và trục.

Các tuỳ chọn được trả về là không thể thay đổi.

Cầu thủ trả bóng

ChartOptions – Các tuỳ chọn cho biểu đồ này, chẳng hạn như chiều cao, màu sắc và trục.

`getRanges()`

Trả về các dải ô mà biểu đồ này sử dụng làm nguồn dữ liệ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();

const ranges = chart.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 đồ này

`getTransposeRowsAndColumns()`

Nếu là true, các hàng và cột dùng để điền sẵn biểu đồ 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()
                  .addRange(range)
                  .setChartType(Charts.ChartType.BAR)
                  .setTransposeRowsAndColumns(true)
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs whether rows and columns should be transposed, which is true in this
// case.
Logger.log(chart.getTransposeRowsAndColumns());

Cầu thủ trả bóng

Boolean – true nếu các hàng và cột dùng để tạo biểu đồ được hoán vị.

`modify()`

Trả về một EmbeddedChartBuilder có thể dùng để sửa đổi biểu đồ này. Gọi sheet.updateChart(chart) để lưu mọi thay đổi.

const sheet = SpreadsheetApp.getActiveSheet();
let chart = sheet.getCharts()[0];
chart = chart.modify()
            .setOption('width', 800)
            .setOption('height', 640)
            .setPosition(5, 5, 0, 0)
            .build();
sheet.updateChart(chart);

Cầu thủ trả bóng

EmbeddedChartBuilder – một trình tạo để tạo biểu đồ được nhúng