Class PositionedImage

PositionedImage

Hình ảnh ở vị trí cố định được gắn vào một Paragraph. Không giống như InlineImage, PositionedImage không phải là Element. Thẻ này không có thẻ mẹ hoặc thẻ anh chị em Element. Thay vào đó, thành phần này được cố định vào một Paragraph hoặc ListItem và được đặt thông qua các khoảng cách từ điểm cố định đó. PositionedImage có một mã nhận dạng mà bạn có thể dùng để tham chiếu đến mã này. 

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ứcKiểu 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 đã 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()PositionedLayoutLấy một giá trị enum biểu thị cách bố trí hình ảnh.
getLeftOffset()NumberLấy độ lệch của hình ảnh (tính bằng điểm) so với bên trái của đoạn văn.
getParagraph()ParagraphLấy Paragraph mà hình ảnh được neo vào.
getTopOffset()NumberLấy độ lệch của hình ảnh (tính bằng điểm) so với đầu đoạn vă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) so với bên trái của đoạn văn.
setTopOffset(offset)PositionedImageĐặt độ lệch của hình ảnh (tính bằng điểm) so với đầu đoạn vă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 đã chỉ định. Phương thức này sẽ thêm đuôi thích hợp vào tên tệp, chẳng hạn như "myfile.pdf". Tuy nhiên, phương thức 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 tiện ích 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 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 phải tuân thủ hạn mức nghiêm ngặt hơn.

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, mọi định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' 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 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLayout()

Lấy một giá trị enum biểu thị 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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) so với bên trái của đoạn vă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 trái

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 gốc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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) so với đầu đoạn văn.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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) so với bên trái của đoạn văn.

Tham số

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

Cầu thủ trả bóng

PositionedImage – đối tượng này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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) so với đầu đoạn văn.

Tham số

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

Cầu thủ trả bóng

PositionedImage – đối tượng này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents