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

Class PositionedImage

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()`

Lấy Paragraph mà hình ảnh liên kết đến.

Cầu thủ trả bóng

Paragraph – đoạn 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

`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