รูปภาพที่มีตำแหน่งคงที่ซึ่งยึดอยู่กับ 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 | คำอธิบาย |
---|---|---|
contentType | String | ประเภท MIME ที่จะแปลงเป็น สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณสามารถใช้ 'image/bmp' , 'image/gif' , 'image/jpeg' หรือ 'image/png' ได้เช่นกัน |
รีเทิร์น
Blob
— ข้อมูลในรูปแบบ BLOB
getBlob()
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()
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 | คำอธิบาย |
---|---|---|
height | Integer | ความสูงของรูปภาพเป็นพิกเซล |
รีเทิร์น
PositionedImage
— ออบเจ็กต์ปัจจุบัน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
กำหนดคำจำกัดความของการจัดรูปภาพ
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
layout | PositionedLayout | enum ที่แสดงถึงโหมดเลย์เอาต์ |
รีเทิร์น
PositionedImage
— ออบเจ็กต์นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
ตั้งค่าออฟเซ็ตของภาพเป็นจุดจากด้านซ้ายของย่อหน้า
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
offset | Number | ชดเชยจากด้านซ้ายของย่อหน้า |
รีเทิร์น
PositionedImage
— ออบเจ็กต์นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
ตั้งค่าออฟเซ็ตของภาพเป็นจุดจากด้านบนของย่อหน้า
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
offset | Number | จากด้านบนของย่อหน้า |
รีเทิร์น
PositionedImage
— ออบเจ็กต์นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
กำหนดความกว้างของรูปภาพเป็นพิกเซล
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
width | Integer | ความกว้างของรูปภาพเป็นพิกเซล |
รีเทิร์น
PositionedImage
— ออบเจ็กต์ปัจจุบัน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents