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

Class EmbeddedChart

Đại diện cho biểu đồ đã được nhúng vào bảng tính.

Ví dụ sau trình bày cách sửa đổi một biểu đồ hiện có:

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

Ví dụ sau đây trình bày cách tạo biểu đồ mới:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var 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	Kiểu dữ liệu trả về	Mô tả ngắn
`asDataSourceChart()`	`DataSourceChart`	Chuyển đến một bản sao biểu đồ nguồn dữ liệu nếu biểu đồ đó là biểu đồ nguồn dữ liệu, hoặc `null`.
`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 được chỉ định.
`getBlob()`	`Blob`	Trả về dữ liệu bên trong đối tượng này dưới dạng một 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 ở trong một 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 bị ẩn.
`getMergeStrategy()`	`ChartMergeStrategy`	Trả về chiến lược hợp nhất được sử dụng khi tồn tại nhiều dải ô.
`getNumHeaders()`	`Integer`	Trả về số hàng hoặc số cột mà 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 giá trị là `true`, các hàng và cột dùng để điền vào 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()`

Chuyển đến một bản sao biểu đồ nguồn dữ liệu nếu biểu đồ đó là biểu đồ nguồn dữ liệu, hoặc null.

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 được chỉ định. Phương thức này sẽ thêm phần mở rộng thích hợp vào tên tệp – ví dụ: "myfile.pdf". Tuy nhiên, giả định rằng phần tên tệp đứng sau dấu chấm gần nhất (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" 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 các Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời tuân theo định mức nghiêm ngặt hơn.

Các tham số

Tên	Loại	Nội dung mô tả
`contentType`	`String`	Loại MIME cần chuyển đổi. Đố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 có định dạng BMP, GIF, JPEG hoặc PNG, mọi giá trị `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hay `'image/png'` cũng hợp lệ.

Cầu thủ trả bóng

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

`getBlob()`

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

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng một 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 ở trong một bảng tính.

Cầu thủ trả bóng

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

`getContainerInfo()`

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

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

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

// 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 bị ẩn.

`getMergeStrategy()`

Trả về chiến lược hợp nhất được sử dụng khi tồn tại nhiều dải ô. Nếu là MERGE_ROWS, 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("C1:C10");
var 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 dải ô; MERGE_COLUMNS nếu các cột được hợp nhất trên nhiều dải ô

`getNumHeaders()`

Trả về số hàng hoặc số cột mà 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()

// 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 xem là tiêu đề. Giá trị âm cho biết tiêu đề được phát hiện tự động.

`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.

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

var ranges = chart.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à nguồn dữ liệu của biểu đồ này

`getTransposeRowsAndColumns()`

Nếu giá trị là true, các hàng và cột dùng để điền vào biểu đồ 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()
    .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 đồ bị 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 — trình tạo để tạo các biểu đồ nhúng