Class PositionedImage

รูปภาพตามตําแหน่ง

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

ไปกลับ

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 — การชดเชยรูปภาพจากย่อหน้าด้านซ้าย's ด้านซ้าย

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

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

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

getParagraph()

รับ Paragraph ที่แท็กเป็น Anchor

ไปกลับ

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)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
layoutPositionedLayoutenum แสดงโหมดของเลย์เอาต์

ไปกลับ

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