Class PositionedImage

Hình ảnhđược định vị

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 đó, thành phần hiển thị này được liên kết với Paragraph hoặc ListItem và được đặt thông qua các độ dời từ liên kết đó. PositionedImage có một mã nhận dạng có thể dùng để tham chiếu đến PositionedImage đó. 

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
const posImage =
    paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getAs(contentType)BlobTrả 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 đã chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng blob.
getHeight()IntegerTruy xuất chiều cao của hình ảnh, tính bằng pixel.
getId()StringLấy mã nhận dạng của hình ảnh.
getLayout()PositionedLayoutLấy một giá trị enum thể hiện cách bố trí hình ảnh.
getLeftOffset()NumberLấy độ lệch của hình ảnh, tính bằng điểm, từ bên trái của đoạn văn bản.
getParagraph()ParagraphLấy Paragraph mà hình ảnh được neo vào.
getTopOffset()NumberLấy độ dời của hình ảnh, tính bằng điểm, từ đầu đoạn văn bản.
getWidth()IntegerTruy 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 văn bản.
setTopOffset(offset)PositionedImageĐặt độ dời của hình ảnh, tính bằng điểm, từ đầu đoạn văn bả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 đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ 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 Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân theo hạn mức nghiêm ngặt hơn.

Tham số

TênLoạiMô tả
contentTypeStringLoại MIME cần chuyển đổi sang. Đố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 ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' nào cũng đều hợp lệ. Đối với tài liệu 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 blob.

getBlob()

Trả về dữ liệu bên trong đối tượng này dưới dạng blob.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ã nhận dạng hình ảnh

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

Lấy 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 bằng điểm, từ bên trái của đoạn văn bản.

Cầu thủ trả bóng

Number – độ lệch hình ảnh so với bên trái của đoạn văn bản bên trái

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được neo vào.

Cầu thủ trả bóng

Paragraph – đoạn văn bản mẹ

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 độ dời của hình ảnh, tính bằng điểm, từ đầu đoạn văn bản.

Cầu thủ trả bóng

Number – độ dời hình ảnh so với đầu đoạn văn bản bên trái

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô tả
heightIntegerchiề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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô tả
layoutPositionedLayoutmộ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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, tính bằng điểm, từ bên trái của đoạn văn bản.

Tham số

TênLoạiMô tả
offsetNumberđộ lệch từ bên trái của đoạn văn bản

Cầu thủ trả bóng

PositionedImage – đối tượng này để tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 độ dời của hình ảnh, tính bằng điểm, từ đầu đoạn văn bản.

Tham số

TênLoạiMô tả
offsetNumberđộ lệch so với đầu đoạn văn bản

Cầu thủ trả bóng

PositionedImage – đối tượng này để tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô tả
widthIntegerchiề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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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