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

Class InlineImage

Một phần tử đại diện cho một hình ảnh được nhúng. Có thể chứa InlineImage trong một ListItem hoặc Paragraph, trừ phi ListItem hoặc Paragraph nằm trong FootnoteSection. Bản thân InlineImage không được chứa bất kỳ phần tử nào khác. Để để biết thêm thông tin về cấu trúc tài liệu, hãy xem hướng dẫn mở rộng Google Tài liệu.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`copy()`	`InlineImage`	Trả về một bản sao sâu, tách biệt của phần tử hiện tại.
`getAltDescription()`	`String`	Trả về nội dung mô tả thay thế của hình ảnh.
`getAltTitle()`	`String`	Trả về tiêu đề thay thế của hình ảnh.
`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 sang loại nội dung được chỉ định.
`getAttributes()`	`Object`	Truy xuất các thuộc tính của phần tử.
`getBlob()`	`Blob`	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob.
`getHeight()`	`Integer`	Truy xuất chiều cao của hình ảnh, tính bằng pixel.
`getLinkUrl()`	`String`	Truy xuất URL liên kết.
`getNextSibling()`	`Element`	Truy xuất phần tử đồng cấp tiếp theo của phần tử đó.
`getParent()`	`ContainerElement`	Truy xuất phần tử mẹ của phần tử đó.
`getPreviousSibling()`	`Element`	Truy xuất phần tử đồng cấp trước đó của phần tử.
`getType()`	`ElementType`	Truy xuất `ElementType` của phần tử.
`getWidth()`	`Integer`	Truy xuất chiều rộng của hình ảnh, tính bằng pixel.
`isAtDocumentEnd()`	`Boolean`	Xác định xem phần tử có nằm ở cuối `Document` hay không.
`merge()`	`InlineImage`	Hợp nhất phần tử với phần tử đồng cấp trước đó thuộc cùng loại.
`removeFromParent()`	`InlineImage`	Xoá phần tử khỏi phần tử mẹ.
`setAltDescription(description)`	`InlineImage`	Đặt mô tả thay thế cho hình ảnh.
`setAltTitle(title)`	`InlineImage`	Đặt tiêu đề thay thế cho hình ảnh.
`setAttributes(attributes)`	`InlineImage`	Thiết lập các thuộc tính của phần tử.
`setHeight(height)`	`InlineImage`	Đặt chiều cao của hình ảnh, tính bằng pixel.
`setLinkUrl(url)`	`InlineImage`	Đặt URL liên kết.
`setWidth(width)`	`InlineImage`	Đặt chiều rộng của hình ảnh, tính bằng pixel.

Tài liệu chi tiết

`copy()`

Trả về một bản sao sâu, tách biệt của phần tử hiện tại.

Mọi phần tử con có trong phần tử đó cũng được sao chép. Phần tử mới không có cha mẹ.

Cầu thủ trả bóng

InlineImage — Bản sao mới.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getAltDescription()`

Trả về nội dung mô tả thay thế của hình ảnh.

Cầu thủ trả bóng

String – tiêu đề thay thế hoặc null nếu phần tử không có tiêu đề thay thế

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getAltTitle()`

Trả về tiêu đề thay thế của hình ảnh.

Cầu thủ trả bóng

String – tiêu đề thay thế hoặc null nếu phần tử không có tiêu đề thay thế

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`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ên	Loại	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à 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.

`getAttributes()`

Truy xuất các thuộc tính của phần tử.

Kết quả là một đối tượng chứa một thuộc tính cho từng thuộc tính phần tử hợp lệ, trong đó mỗi thuộc tính tên thuộc tính tương ứng với một mục trong bản liệt kê DocumentApp.Attribute.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Cầu thủ trả bóng

Object – Các thuộc tính của phần tử.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

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

`getHeight()`

Truy xuất chiều cao của hình ảnh, tính bằng pixel.

Cầu thủ trả bóng

Integer — chiều cao của hình ảnh, tính bằng pixel

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLinkUrl()`

Truy xuất URL liên kết.

Cầu thủ trả bóng

String – URL liên kết hoặc null nếu phần tử chứa nhiều giá trị cho URL này .

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNextSibling()`

Truy xuất phần tử đồng cấp tiếp theo của phần tử đó.

Phần tử đồng cấp tiếp theo có cùng phần tử mẹ và theo sau phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử đồng cấp tiếp theo.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParent()`

Truy xuất phần tử mẹ của phần tử đó.

Phần tử mẹ chứa phần tử hiện tại.

Cầu thủ trả bóng

ContainerElement – Phần tử mẹ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPreviousSibling()`

Truy xuất phần tử đồng cấp trước đó của phần tử.

Phần tử đồng cấp trước có cùng phần tử mẹ và đứng trước phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử đồng cấp trước đó.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getType()`

Truy xuất ElementType của phần tử.

Dùng getType() để xác định loại chính xác của một phần tử nhất định.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Cầu thủ trả bóng

ElementType — Loại phần tử.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getWidth()`

Truy xuất chiều rộng của hình ảnh, tính bằng pixel.

Cầu thủ trả bóng

Integer – chiều rộng của hình ảnh, tính bằng pixel

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isAtDocumentEnd()`

Xác định xem phần tử có nằm ở cuối Document hay không.

Cầu thủ trả bóng

Boolean – Liệu phần tử này có nằm ở cuối thẻ hay không.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`merge()`

Hợp nhất phần tử với phần tử đồng cấp trước đó thuộc cùng loại.

Chỉ có thể hợp nhất các phần tử của cùng một ElementType. Mọi phần tử con có trong phần tử hiện tại sẽ được di chuyển đến phần tử cùng cấp trước đó.

Phần tử hiện tại sẽ bị xoá khỏi tài liệu.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Cầu thủ trả bóng

InlineImage – Phần tử đã hợp nhất.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeFromParent()`

Xoá phần tử khỏi phần tử mẹ.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab()
var body = documentTab.getBody();

// Remove all images in the active tab's body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Cầu thủ trả bóng

InlineImage – Phần tử đã bị xoá.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAltDescription(description)`

Đặt mô tả thay thế cho hình ảnh. Nếu tiêu đề đã cho là null, hãy đặt giá trị mô tả cho chuỗi trống.

Tham số

Tên	Loại	Mô tả
`description`	`String`	tiêu đề thay thế

Cầu thủ trả bóng

InlineImage – đối tượng hiện tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAltTitle(title)`

Đặt tiêu đề thay thế cho hình ảnh. Nếu tiêu đề đã cho là null, hãy đặt tiêu đề thành chuỗi trống.

Tham số

Tên	Loại	Mô tả
`title`	`String`	tiêu đề thay thế

Cầu thủ trả bóng

InlineImage – đối tượng hiện tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAttributes(attributes)`

Thiết lập các thuộc tính của phần tử.

Thông số thuộc tính được chỉ định phải là một đối tượng, trong đó mỗi tên thuộc tính là một mục trong bản liệt kê DocumentApp.Attribute và mỗi giá trị thuộc tính là một giá trị mới áp dụng.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Tham số

Tên	Loại	Mô tả
`attributes`	`Object`	Các thuộc tính của phần tử.

Cầu thủ trả bóng

InlineImage — Phần tử hiện tại.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setHeight(height)`

Đặt chiều cao của hình ảnh, tính bằng pixel.

Tham số

Tên	Loại	Mô tả
`height`	`Integer`	chiều cao của hình ảnh, tính bằng pixel

Cầu thủ trả bóng

InlineImage – đối tượng hiện tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLinkUrl(url)`

Đặt URL liên kết. Nếu URL đã cho là null hoặc một chuỗi trống, phương thức này sẽ tạo đường liên kết có URL trống có thể hiển thị là "Đường liên kết không hợp lệ" trong Google Tài liệu.

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL liên kết

Cầu thủ trả bóng

InlineImage – đối tượng hiện tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setWidth(width)`

Đặt chiều rộng của hình ảnh, tính bằng pixel.

Tham số

Tên	Loại	Mô tả
`width`	`Integer`	chiều rộng của hình ảnh, tính bằng pixel

Cầu thủ trả bóng

InlineImage – đối tượng hiện tại

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents