Một phần tử đại diện cho một hình ảnh được nhúng. InlineImage
có thể nằm trong 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
copy() | InlineImage | Trả về một bản sao sâu đã tách rời 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 thành 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ử phụ 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ử phụ 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ử này có nằm ở cuối Document hay không. |
merge() | InlineImage | Hợp nhất phần tử với phần tử phụ thuộc cùng một loại trước đó. |
removeFromParent() | InlineImage | Xoá phần tử khỏi phần tử mẹ. |
setAltDescription(description) | InlineImage | Đặt nội dung mô tả thay thế của 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 rời 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ó phần tử 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 cần được uỷ 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 cần được uỷ 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 cần được uỷ 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 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.
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 thuộc tính cho mỗi thuộc tính phần tử hợp lệ, trong đó mỗi tên thuộc tính tương ứng với một mục trong bảng liệt kê DocumentApp.Attribute
.
var body = DocumentApp.getActiveDocument().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 cần được uỷ 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 cần được uỷ 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 thuộc tính này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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ử phụ tiếp theo của phần tử.
Thành phần đồng cấp tiếp theo có cùng thành phần mẹ và theo sau phần tử hiện tại.
Cầu thủ trả bóng
Element
– Phần tử phụ tiếp theo.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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 cần được uỷ 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ử phụ trước đó của phần tử.
Thành phần đồng cấp trước có cùng thành phần mẹ và đứng trước phần tử hiện tại.
Cầu thủ trả bóng
Element
– Phần tử phụ trước đó.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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ử.
Sử dụng getType()
để xác định loại chính xác của một phần tử nhất định.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document 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 cần được uỷ 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 cần được uỷ 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ử này có nằm ở cuối Document
hay không.
Cầu thủ trả bóng
Boolean
– Liệu phần tử có nằm ở cuối tài liệu hay không.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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ử phụ thuộc cùng một loại trước đó.
Bạn 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 đều được chuyển sang phần tử phụ trước đó.
Phần tử hiện tại đã bị xoá khỏi tài liệu.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. 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 cần được uỷ 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 body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document 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 cần được uỷ 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 nội dung mô tả thay thế của hình ảnh. Nếu tiêu đề đã cho là null
, hãy đặt nội dung mô tả thành chuỗi trống.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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ử.
Tham 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ảng liệt kê DocumentApp.Attribute
và mỗi giá trị thuộc tính là một giá trị mới sẽ được áp dụng.
var body = DocumentApp.getActiveDocument().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);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
attributes | Object | 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 cần được uỷ 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.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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 được cung cấp là null
hoặc một chuỗi trống, phương thức này sẽ tạo một đường liên kết có URL trống và có thể hiển thị dưới dạng "Đường liên kết không hợp lệ" trong Google Tài liệu.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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