Đã liên kết hình ảnh vị trí cố định vào Paragraph
. Không giống như InlineImage
, PositionedImage
là
không phải Element
. Chiến dịch này không có
cha mẹ hoặc đồng cấp Element
. Thay vào đó,
phần tử này được neo vào Paragraph
hoặc ListItem
và được đặt thông qua các giá trị bù trừ từ
điểm neo đó. PositionedImage
có một mã nhận dạng có thể dùng để tham chiếu đến.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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 | Loại 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 sang 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 đại diện cho cách hình ảnh được bố trí. |
getLeftOffset() | Number | Lấy độ lệch của hình ảnh, tính bằng điểm, từ bên trái của đoạn. |
getParagraph() | Paragraph | Lấy Paragraph liên kết với hình ảnh. |
getTopOffset() | Number | Lấy độ lệch của hình ảnh, tính bằng đ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, tính bằng điểm, từ bên trái của đoạn. |
setTopOffset(offset) | PositionedImage | Đặt độ lệch của hình ảnh, tính bằng đ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 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.
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
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 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
getLayout()
Nhận một giá trị enum đại diện cho cách hình ảnh được bố trí.
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 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
getLeftOffset()
Lấy độ lệch của hình ảnh, tính bằng điểm, từ bên trái của đoạn.
Cầu thủ trả bóng
Number
— phần bù trừ hình ảnh từ bên trái đoạn văn bản
Ủ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
getParagraph()
getTopOffset()
Lấy độ lệch của hình ảnh, tính bằng điểm, từ đầu đoạn.
Cầu thủ trả bóng
Number
— phần bù trừ của hình ảnh tính từ phần trên cùng 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 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
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
PositionedImage
– đố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
setLayout(layout)
Đặt định nghĩa về cách bố trí hình ảnh.
Tham số
Tên | Loại | Mô tả |
---|---|---|
layout | PositionedLayout | một enum đại diện cho 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 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
setLeftOffset(offset)
Đặt độ lệch của hình ảnh, tính bằng điểm, từ bên trái của đoạn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
offset | Number | bù trừ ở bên trái của đ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 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
setTopOffset(offset)
Đặt độ lệch của hình ảnh, tính bằng điểm, tính từ đầu đoạn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
offset | Number | bù trừ khỏ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 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
PositionedImage
– đố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