Class PositionedImage

PositionedImage

รูปภาพที่มีตำแหน่งคงที่ซึ่งยึดอยู่กับ Paragraph PositionedImage ไม่ใช่ Element ซึ่งแตกต่างจาก InlineImage ซึ่งไม่มี Element ระดับบนสุดหรือระดับข้างเคียง แต่จะยึดกับ Paragraph หรือ ListItem แทน และวางผ่านออฟเซ็ตจากจุดยึดนั้น PositionedImage มีรหัสที่ใช้อ้างอิงได้

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

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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 ที่สร้างใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดเป็นการชั่วคราว

พารามิเตอร์

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

รีเทิร์น

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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setLayout(layout)

กำหนดคำจำกัดความของการจัดรูปภาพ

พารามิเตอร์

ชื่อTypeคำอธิบาย
layoutPositionedLayoutenum ที่แสดงถึงโหมดเลย์เอาต์

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สำหรับการทำเชน

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

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

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

setLeftOffset(offset)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
offsetNumberชดเชยจากด้านซ้ายของย่อหน้า

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สำหรับการทำเชน

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

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

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

setTopOffset(offset)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
offsetNumberจากด้านบนของย่อหน้า

รีเทิร์น

PositionedImage — ออบเจ็กต์นี้สำหรับการทำเชน

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

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

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

setWidth(width)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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