หน้านี้ได้รับการแปลโดย Cloud Translation API

Class PositionedImage

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

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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 ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`contentType`	`String`	ประเภท MIME ที่จะแปลง สำหรับ BLOB ส่วนใหญ่ `'application/pdf'` คือ เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG ระบบจะใช้ `'image/bmp'`, `'image/gif'`, `'image/jpeg'` หรือ `'image/png'` ด้วย ใช้ได้ ใช้ `'text/markdown'` สำหรับเอกสารของ Google เอกสารได้ด้วย

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB

`getBlob()`

แสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB

`getHeight()`

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

รีเทิร์น

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

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

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

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

`getId()`

รับรหัสของรูปภาพ

รีเทิร์น

String — รหัสรูปภาพ

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

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

`getLayout()`

ได้ค่า enum ที่แสดงรูปแบบการจัดวางรูปภาพ

รีเทิร์น

PositionedLayout — เลย์เอาต์รูปภาพ

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

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

`getLeftOffset()`

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

รีเทิร์น

Number — ออฟเซ็ตรูปภาพจากย่อหน้าด้านซ้าย

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

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

`getParagraph()`

รับ Paragraph ที่ยึดตำแหน่งรูปภาพไว้

รีเทิร์น

Paragraph — ย่อหน้าหลัก

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

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

`getTopOffset()`

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

รีเทิร์น

Number — ออฟเซ็ตรูปภาพจากย่อหน้าด้านซ้าย

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

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

`getWidth()`

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

รีเทิร์น

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

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

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

`setHeight(height)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`setLayout(layout)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`setLeftOffset(offset)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`setTopOffset(offset)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

`setWidth(width)`

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

พารามิเตอร์

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

รีเทิร์น

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

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

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