รูปภาพตําแหน่งคงที่ยึดกับ 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 ที่สร้างใหม่อาจมีโควต้าที่ตายตัวเป็นการชั่วคราว
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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
— การชดเชยรูปภาพจากย่อหน้าด้านซ้าย's ด้านซ้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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)
ตั้งค่าความสูงของรูปภาพเป็นพิกเซล
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
height | Integer | ความสูงของภาพเป็นพิกเซล |
ไปกลับ
PositionedImage
— ออบเจ็กต์ปัจจุบัน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
กําหนดคํานิยามของการจัดวางรูปภาพ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
layout | PositionedLayout | enum แสดงโหมดของเลย์เอาต์ |
ไปกลับ
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