Class EmbeddedChart

EmbeddedChart

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

Dưới đây là ví dụ về 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);

Dưới đây là ví dụ minh hoạ 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ứcLoại dữ liệu trả vềMô tả ngắn
asDataSourceChart()DataSourceChartTruyền đến một phiên bản 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)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung được chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob.
getChartId()IntegerTrả về giá trị nhận dạng cố định cho biểu đồ, giá trị này là duy nhất trên bảng tính có chứa giá trị biểu đồ hoặc null nếu biểu đồ không nằm trong bảng tính.
getContainerInfo()ContainerInfoTrả về thông tin về vị trí biểu đồ trong một trang tính.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyTrả về chiến lược để sử dụng để xử lý các hàng và cột bị ẩn.
getMergeStrategy()ChartMergeStrategyTrả về chiến lược hợp nhất được sử dụng khi có nhiều dải ô tồn tại.
getNumHeaders()IntegerTrả về số lượng hàng hoặc cột của dải ô được coi là tiêu đề.
getOptions()ChartOptionsTrả 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()BooleanNếu giá trị trả về là true, các hàng và cột dùng để điền vào biểu đồ sẽ được chuyển đổi.
modify()EmbeddedChartBuilderTrả về 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 phiên bản 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 sang loại nội dung được chỉ định. Chiến dịch này sẽ thêm đuôi tệp thích hợp vào tên tệp (ví dụ: "myfile.pdf"). Tuy nhiên, việc này giả định rằng phần tên tệp tiếp sau dấu chấm cuối cùng (nếu có) là phần tên tệp hiện có tiện ích mở rộng 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 Google Dịch vụ. Các miền Google Workspace mới tạo có thể tạm thời bị áp dụng quy định nghiêm ngặt hơn hạn mức.

Tham số

TênLoạiMô tả
contentTypeStringLoại MIME cần chuyển đổi. Đối với hầu hết các blob, 'application/pdf' là lựa 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ỳ hình ảnh nào có định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' cũng hợp lệ. Đối với tài liệu trên 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 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ề giá trị nhận dạng cố định cho biểu đồ, giá trị này là duy nhất trên bảng tính có chứa giá trị 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í 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 để 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 có nhiều dải ô tồn tại. Nếu là MERGE_ROWS, 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("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

ChartMergeStrategyMERGE_ROWS nếu các hàng được hợp nhất trên nhiều hàng các dải ô; MERGE_COLUMNS nếu các cột được hợp nhất trên nhiều phạm vi


getNumHeaders()

Trả về 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()

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

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 dải ô đóng vai trò là nguồn dữ liệu của biểu đồ này


getTransposeRowsAndColumns()

Nếu giá trị trả về là true, các hàng và cột dùng để điền vào biểu đồ sẽ được chuyển đổi. 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

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


modify()

Trả về 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 — một trình tạo biểu đồ được nhúng