Class PositionedImage

PositionedImage

Đã 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ứ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 sang loại nội dung được chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một 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()PositionedLayoutNhận một giá trị enum đại diện cho cách hình ảnh được bố trí.
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.
getParagraph()ParagraphLấy Paragraph liên kết với hình ảnh.
getTopOffset()NumberLấy độ lệch của hình ảnh, tính bằng điểm, từ đầu đoạ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.
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ênLoạiMô tả
contentTypeStringLoạ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()

Lấy Paragraph liên kết với hình ảnh.

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 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

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ê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

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ê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

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ênLoạiMô tả
offsetNumberbù 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ênLoạiMô tả
offsetNumberbù 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ê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

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