Class PositionedImage

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
contentType	String	ประเภท 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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setLayout(layout)

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

พารามิเตอร์

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

รีเทิร์น

PositionedImage - ออบเจ็กต์นี้สำหรับการเชื่อมโยง

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

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

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

---

setLeftOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

PositionedImage - ออบเจ็กต์นี้สำหรับการเชื่อมโยง

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

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

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

---

setTopOffset(offset)

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

พารามิเตอร์

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

รีเทิร์น

PositionedImage - ออบเจ็กต์นี้สำหรับการเชื่อมโยง

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

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

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

---

setWidth(width)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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