Class PositionedImage

รูปภาพที่วางตำแหน่ง

รูปภาพตำแหน่งคงที่ที่ยึดอยู่กับ Paragraph PositionedImage ไม่ใช่ Element ต่างจาก InlineImage รายการนั้นไม่มีElement ที่เป็นรายการหลักหรือรายการพี่น้อง แต่ยึดอยู่ที่ Paragraph หรือ ListItem และวางไว้ผ่านออฟเซตจากจุดยึดนั้น 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);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getAs(contentType)Blobแสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ
getBlob()Blobแสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob
getHeight()Integerดึงข้อมูลความสูงของรูปภาพเป็นพิกเซล
getId()Stringรับรหัสของรูปภาพ
getLayout()PositionedLayoutรับค่า Enum ที่แสดงถึงการจัดวางรูปภาพ
getLeftOffset()Numberรับระยะห่างของรูปภาพเป็นจุดจากด้านซ้ายของย่อหน้า
getParagraph()Paragraphรับ Paragraph ที่รูปภาพยึดอยู่
getTopOffset()Numberรับระยะห่างของรูปภาพเป็นจุดจากด้านบนของย่อหน้า
getWidth()Integerดึงข้อมูลความกว้างของรูปภาพเป็นพิกเซล
setHeight(height)PositionedImageตั้งค่าความสูงของรูปภาพเป็นพิกเซล
setLayout(layout)PositionedImageกำหนดการกำหนดลักษณะการจัดวางรูปภาพ
setLeftOffset(offset)PositionedImageตั้งค่าระยะห่างของรูปภาพเป็นจุดจากด้านซ้ายของย่อหน้า
setTopOffset(offset)PositionedImageตั้งค่าระยะห่างของรูปภาพเป็นจุดจากด้านบนของย่อหน้า
setWidth(width)PositionedImageตั้งค่าความกว้างของรูปภาพเป็นพิกเซล

เอกสารประกอบโดยละเอียด

getAs(contentType)

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ วิธีนี้จะเพิ่มนามสกุลที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม ระบบจะถือว่าส่วนชื่อไฟล์ที่อยู่หลังจุดสุดท้าย (หากมี) เป็นนามสกุลที่มีอยู่ซึ่งควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" จะเปลี่ยนเป็น "ShoppingList.12.25.pdf"

หากต้องการดูโควต้า Conversion รายวัน โปรดดูโควต้าสําหรับบริการของ Google โดเมน Google Workspace ที่สร้างขึ้นใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดขึ้นชั่วคราว

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลง สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG จะใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ก็ได้ สำหรับเอกสาร Google เอกสาร จะใช้ 'text/markdown' ก็ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลเป็น Blob

getBlob()

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob

รีเทิร์น

Blob — ข้อมูลเป็น Blob

getHeight()

ดึงข้อมูลความสูงของรูปภาพเป็นพิกเซล

รีเทิร์น

Integer — ความสูงของรูปภาพเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getId()

รับรหัสของรูปภาพ

รีเทิร์น

String — รหัสรูปภาพ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getLayout()

รับค่า Enum ที่แสดงถึงการจัดวางรูปภาพ

รีเทิร์น

PositionedLayout — เลย์เอาต์รูปภาพ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getLeftOffset()

รับระยะห่างของรูปภาพเป็นจุดจากด้านซ้ายของย่อหน้า

รีเทิร์น

Number — ระยะห่างของรูปภาพจากด้านซ้ายของย่อหน้าด้านซ้าย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getParagraph()

รับ Paragraph ที่รูปภาพยึดอยู่

รีเทิร์น

Paragraph — ย่อหน้าหลัก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTopOffset()

รับระยะห่างของรูปภาพเป็นจุดจากด้านบนของย่อหน้า

รีเทิร์น

Number — ระยะห่างของรูปภาพจากด้านบนของย่อหน้าด้านซ้าย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWidth()

ดึงข้อมูลความกว้างของรูปภาพเป็นพิกเซล

รีเทิร์น

Integer — ความกว้างของรูปภาพเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHeight(height)

ตั้งค่าความสูงของรูปภาพเป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
heightIntegerความสูงของรูปภาพเป็นพิกเซล

รีเทิร์น

PositionedImage — ออบเจ็กต์ปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setLayout(layout)

กำหนดการกำหนดลักษณะการจัดวางรูปภาพ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
layoutPositionedLayoutอาร์เรย์แบบจำกัดที่แสดงโหมดเลย์เอาต์

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สําหรับการต่อเชื่อม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setLeftOffset(offset)

ตั้งค่าระยะห่างของรูปภาพเป็นจุดจากด้านซ้ายของย่อหน้า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
offsetNumberระยะห่างจากด้านซ้ายของย่อหน้า

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สําหรับการต่อเชื่อม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTopOffset(offset)

ตั้งค่าระยะห่างของรูปภาพเป็นจุดจากด้านบนของย่อหน้า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
offsetNumberระยะห่างจากด้านบนของย่อหน้า

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สําหรับการต่อเชื่อม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWidth(width)

ตั้งค่าความกว้างของรูปภาพเป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
widthIntegerความกว้างของรูปภาพเป็นพิกเซล

รีเทิร์น

PositionedImage — ออบเจ็กต์ปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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