Hình ảnh vị trí cố định được neo vào Paragraph
. Không giống như InlineImage
, PositionedImage
không phải là Element
. Không có Element
mẹ hoặc anh chị em. Thay vào đó, mô-đun này được liên kết với Paragraph
hoặc ListItem
và được đặt thông qua các độ lệch của liên kết đó. PositionedImage
có một mã nhận dạng dùng để tham chiếu đến mã đó.
var body = DocumentApp.getActiveDocument().getBody(); // Append a new paragraph. var paragraph = body.appendParagraph("New paragraph to anchor the image to."); // Get an image in Drive from its ID. var image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob(); // Add the PositionedImage with offsets (in points). var posImage = paragraph.addPositionedImage(image) .setTopOffset(60) .setLeftOffset(40);
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
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. |
getHeight() | Integer | Truy xuất chiều cao của hình ảnh, tính bằng pixel. |
getId() | String | Lấy mã nhận dạng của hình ảnh. |
getLayout() | PositionedLayout | Nhận một giá trị enum thể hiện cách bố trí hình ảnh. |
getLeftOffset() | Number | Lấy độ lệch của hình ảnh (tính theo điểm) ở bên trái đoạn. |
getParagraph() | Paragraph | Lấy Paragraph mà hình ảnh liên kết đến. |
getTopOffset() | Number | Lấy độ lệch của hình ảnh (tính theo điểm) từ đầu đoạn. |
getWidth() | Integer | Truy xuất chiều rộng của hình ảnh, tính bằng pixel. |
setHeight(height) | PositionedImage | Đặt chiều cao của hình ảnh, tính bằng pixel. |
setLayout(layout) | PositionedImage | Đặt định nghĩa về cách bố trí hình ảnh. |
setLeftOffset(offset) | PositionedImage | Đặt độ lệch của hình ảnh, theo điểm, từ bên trái đoạn. |
setTopOffset(offset) | PositionedImage | Đặt độ lệch của hình ảnh (tính theo điểm) tính từ đầu đoạn. |
setWidth(width) | PositionedImage | Đặt chiều rộng của hình ảnh, tính bằng pixel. |
Tài liệu chi tiết
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.
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
getId()
Lấy mã nhận dạng của hình ảnh.
Cầu thủ trả bóng
String
– mã hình ảnh
Ủ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
getLayout()
Nhận một giá trị enum thể hiện cách bố trí hình ảnh.
Cầu thủ trả bóng
PositionedLayout
– bố cục hình ảnh
Ủ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
getLeftOffset()
Lấy độ lệch của hình ảnh (tính theo điểm) ở bên trái đoạn.
Cầu thủ trả bóng
Number
– độ lệch của hình ảnh so với đoạn bên trái của đoạn văn bản bên trá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
getParagraph()
getTopOffset()
Lấy độ lệch của hình ảnh (tính theo điểm) từ đầu đoạn.
Cầu thủ trả bóng
Number
— phần bù trừ của hình ảnh so với đầu đoạn bên trá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
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
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
PositionedImage
– đố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
setLayout(layout)
Đặt định nghĩa về cách bố trí hình ảnh.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
layout | PositionedLayout | một enum biểu thị chế độ bố cục |
Cầu thủ trả bóng
PositionedImage
— đối tượng này để tạo chuỗ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
setLeftOffset(offset)
Đặt độ lệch của hình ảnh, theo điểm, từ bên trái đoạn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
offset | Number | bù trừ bên trái đoạn |
Cầu thủ trả bóng
PositionedImage
— đối tượng này để tạo chuỗ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
setTopOffset(offset)
Đặt độ lệch của hình ảnh (tính theo điểm) tính từ đầu đoạn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
offset | Number | bù trừ so với đầu đoạn |
Cầu thủ trả bóng
PositionedImage
— đối tượng này để tạo chuỗ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
PositionedImage
– đố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