องค์ประกอบภาพที่แสดงผลบนหน้าเว็บ
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
alignOnPage(alignmentPosition) | PageElement | จัดองค์ประกอบให้อยู่ในตําแหน่งการจัดข้อความที่ระบุในหน้า |
asGroup() | Group | แสดงผลองค์ประกอบของหน้าเป็นกลุ่ม |
asImage() | Image | แสดงผลองค์ประกอบของหน้าเป็นรูปภาพ |
asLine() | Line | แสดงองค์ประกอบของหน้าเป็นเส้น |
asShape() | Shape | แสดงผลองค์ประกอบของหน้าเป็นรูปร่าง |
asSheetsChart() | SheetsChart | แสดงองค์ประกอบของหน้าเป็นแผนภูมิที่ลิงก์ซึ่งฝังจาก Google ชีต |
asTable() | Table | แสดงผลองค์ประกอบของหน้าเป็นตาราง |
asVideo() | Video | แสดงผลองค์ประกอบของหน้าเป็นวิดีโอ |
asWordArt() | WordArt | แสดงองค์ประกอบของหน้าเป็นข้อความศิลป์ |
bringForward() | PageElement | นำองค์ประกอบของหน้ามาไว้ด้านหน้าทีละองค์ประกอบ |
bringToFront() | PageElement | นำองค์ประกอบของหน้ามาไว้ที่ด้านบนของหน้า |
duplicate() | PageElement | ทำซ้ำองค์ประกอบของหน้า |
getConnectionSites() | ConnectionSite[] | แสดงรายการ ConnectionSite ในองค์ประกอบของหน้า หรือรายการที่ว่างเปล่าหากองค์ประกอบของหน้าไม่มีเว็บไซต์การเชื่อมต่อ |
getDescription() | String | แสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า |
getHeight() | Number | ดูความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
getInherentHeight() | Number | แสดงผลความสูงปกติขององค์ประกอบเป็นจุด |
getInherentWidth() | Number | แสดงผลความกว้างตามปกติขององค์ประกอบเป็นจุด |
getLeft() | Number | แสดงตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
getObjectId() | String | แสดงรหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้ |
getPageElementType() | PageElementType | แสดงผลประเภทองค์ประกอบของหน้า ซึ่งแสดงเป็น enum PageElementType |
getParentGroup() | Group | แสดงผลกลุ่มองค์ประกอบของหน้านี้ หรือ null หากองค์ประกอบไม่ได้อยู่ในกลุ่ม |
getParentPage() | Page | แสดงหน้าที่มีองค์ประกอบของหน้านี้อยู่ |
getRotation() | Number | แสดงมุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา โดยที่ 0 องศาหมายถึงไม่มีการหมุน |
getTitle() | String | แสดงชื่อข้อความแสดงแทนขององค์ประกอบหน้า |
getTop() | Number | ดึงตำแหน่งแนวตั้งขององค์ประกอบเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
getTransform() | AffineTransform | แสดงการเปลี่ยนรูปแบบขององค์ประกอบหน้า |
getWidth() | Number | แสดงผลความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
preconcatenateTransform(transform) | PageElement | เชื่อมต่อการแปลงที่ระบุล่วงหน้ากับการเปลี่ยนรูปแบบที่มีอยู่ขององค์ประกอบหน้า |
remove() | void | นำองค์ประกอบของหน้าออก |
scaleHeight(ratio) | PageElement | ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ |
scaleWidth(ratio) | PageElement | ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ |
select() | void | เลือกเฉพาะ PageElement ในงานนำเสนอที่ใช้งานอยู่และนำรายการที่เลือกก่อนหน้านี้ออก |
select(replace) | void | เลือก PageElement ในงานนำเสนอที่ใช้งานอยู่ |
sendBackward() | PageElement | ส่งองค์ประกอบของหน้าไปข้างหลังทีละ 1 องค์ประกอบ |
sendToBack() | PageElement | ส่งองค์ประกอบของหน้าไปด้านหลังของหน้า |
setDescription(description) | PageElement | ตั้งค่าคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า |
setHeight(height) | PageElement | กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
setLeft(left) | PageElement | กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
setRotation(angle) | PageElement | ตั้งค่ามุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา |
setTitle(title) | PageElement | ตั้งชื่อข้อความแสดงแทนขององค์ประกอบหน้า |
setTop(top) | PageElement | กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
setTransform(transform) | PageElement | ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าด้วยการเปลี่ยนรูปแบบที่ให้ไว้ |
setWidth(width) | PageElement | กำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
เอกสารประกอบโดยละเอียด
alignOnPage(alignmentPosition)
จัดองค์ประกอบให้อยู่ในตําแหน่งการจัดข้อความที่ระบุในหน้า
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
alignmentPosition | AlignmentPosition | ตำแหน่งที่จะจัดองค์ประกอบของหน้านี้ให้สอดคล้องกันในหน้านั้น |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
asGroup()
asImage()
asLine()
asShape()
asSheetsChart()
แสดงองค์ประกอบของหน้าเป็นแผนภูมิที่ลิงก์ซึ่งฝังจาก Google ชีต
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้าในรูปแบบแผนภูมิ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asTable()
asVideo()
asWordArt()
bringForward()
นำองค์ประกอบของหน้ามาไว้ด้านหน้าทีละองค์ประกอบ
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
นำองค์ประกอบของหน้ามาไว้ที่ด้านบนของหน้า
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
ทำซ้ำองค์ประกอบของหน้า
องค์ประกอบของหน้าที่ซ้ำกันจะวางอยู่ในหน้าเดียวกันที่ตำแหน่งเดียวกับหน้าเดิม
รีเทิร์น
PageElement
— รายการที่ซ้ำกันรายการใหม่ขององค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
แสดงรายการ ConnectionSite
ในองค์ประกอบของหน้า หรือรายการที่ว่างเปล่าหากองค์ประกอบของหน้าไม่มีเว็บไซต์การเชื่อมต่อ
รีเทิร์น
ConnectionSite[]
— รายการเว็บไซต์การเชื่อมต่อ ซึ่งอาจว่างเปล่าหากองค์ประกอบนี้ไม่มีเว็บไซต์การเชื่อมต่อ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
แสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า คำอธิบายจะรวมเข้ากับชื่อ ที่จะแสดงและอ่านข้อความแสดงแทน
รีเทิร์น
String
— คำอธิบายข้อความแสดงแทนขององค์ประกอบหน้าเว็บ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
ดูความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
รีเทิร์น
Number
— ความสูงตามปกติขององค์ประกอบหน้าเว็บในหน่วยจุด หรือ null
หากองค์ประกอบของหน้าไม่มีความสูง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
แสดงผลความสูงปกติขององค์ประกอบเป็นจุด
การเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บจะสัมพันธ์กับขนาดตามปกติ ใช้ขนาดตามปกติร่วมกับการเปลี่ยนรูปแบบขององค์ประกอบเพื่อกำหนดลักษณะที่ปรากฏสุดท้ายขององค์ประกอบ
รีเทิร์น
Number
— ความสูงตามปกติขององค์ประกอบหน้าเว็บในหน่วยจุด หรือ null
หากองค์ประกอบของหน้าไม่มีความสูง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
แสดงผลความกว้างตามปกติขององค์ประกอบเป็นจุด
การเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บจะสัมพันธ์กับขนาดตามปกติ ใช้ขนาดตามปกติร่วมกับการเปลี่ยนรูปแบบขององค์ประกอบเพื่อกำหนดลักษณะที่ปรากฏสุดท้ายขององค์ประกอบ
รีเทิร์น
Number
— ความกว้างตามธรรมชาติขององค์ประกอบหน้าเป็นจุด หรือ null
หากองค์ประกอบหน้าไม่มีความกว้าง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
แสดงตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
รีเทิร์น
Number
— ตำแหน่งแนวนอนขององค์ประกอบนี้เป็นจุดจากมุมบนซ้ายของหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
แสดงรหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้ รหัสออบเจ็กต์ที่ใช้โดยหน้าเว็บและองค์ประกอบของหน้าใช้เนมสเปซเดียวกัน
รีเทิร์น
String
— รหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
แสดงผลประเภทองค์ประกอบของหน้า ซึ่งแสดงเป็น enum PageElementType
รีเทิร์น
PageElementType
— ประเภทองค์ประกอบของหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
แสดงผลกลุ่มองค์ประกอบของหน้านี้ หรือ null
หากองค์ประกอบไม่ได้อยู่ในกลุ่ม
รีเทิร์น
Group
— กลุ่มองค์ประกอบของหน้านี้หรือ null
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
getRotation()
แสดงมุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา โดยที่ 0 องศาหมายถึงไม่มีการหมุน
รีเทิร์น
Number
— มุมการหมุนในหน่วยองศาระหว่าง 0 (รวม) และ 360 (ไม่รวม)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
แสดงชื่อข้อความแสดงแทนขององค์ประกอบหน้า ชื่อจะรวมเข้ากับคำอธิบาย เพื่อแสดงและอ่านข้อความแสดงแทน
รีเทิร์น
String
— ชื่อข้อความแสดงแทนขององค์ประกอบหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
ดึงตำแหน่งแนวตั้งขององค์ประกอบเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
รีเทิร์น
Number
— ตำแหน่งแนวตั้งขององค์ประกอบนี้เป็นจุดจากมุมบนซ้ายของหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
แสดงการเปลี่ยนรูปแบบขององค์ประกอบหน้า
ลักษณะที่ปรากฏขององค์ประกอบในหน้าจะกำหนดโดยการเปลี่ยนรูปแบบสัมบูรณ์ หากต้องการคำนวณการเปลี่ยนรูปแบบสัมบูรณ์ ให้เชื่อมต่อการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บไว้ล่วงหน้ากับการเปลี่ยนรูปแบบของกลุ่มระดับบนสุดทั้งหมด หากองค์ประกอบของหน้าไม่ได้อยู่ในกลุ่ม การเปลี่ยนรูปแบบสัมบูรณ์จะเหมือนกับค่าในช่องนี้
รีเทิร์น
AffineTransform
— การเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
แสดงผลความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
รีเทิร์น
Number
— ความกว้างตามธรรมชาติขององค์ประกอบหน้าเป็นจุด หรือ null
หากองค์ประกอบหน้าไม่มีความกว้าง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
เชื่อมต่อการแปลงที่ระบุล่วงหน้ากับการเปลี่ยนรูปแบบที่มีอยู่ขององค์ประกอบหน้า
newTransform = argument * existingTransform
ตัวอย่างเช่น หากต้องการย้ายองค์ประกอบของหน้า 36 จุดไปทางซ้าย
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
หรือจะแทนที่การเปลี่ยนรูปแบบขององค์ประกอบหน้าด้วย setTransform(transform)
ก็ได้เช่นกัน
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
transform | AffineTransform | การเปลี่ยนรูปแบบที่จะเชื่อมต่อไว้ล่วงหน้าในการเปลี่ยนรูปแบบขององค์ประกอบหน้านี้ |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
นำองค์ประกอบของหน้าออก
หากหลังจากการดำเนินการนำออก Group
มีองค์ประกอบของหน้าเว็บเพียง 1 รายการหรือไม่มีเลย ระบบจะนำกลุ่มออกด้วย
หากนำตัวยึดตำแหน่ง PageElement
ออกจากต้นแบบหรือเลย์เอาต์ ตัวยึดตำแหน่งที่รับค่าเดิมมาใดๆ ก็จะถูกนำออกด้วย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ ความสูงขององค์ประกอบคือความสูงของกรอบ ล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
ratio | Number | อัตราส่วนที่ใช้กำหนดความสูงขององค์ประกอบของหน้านี้ |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ ความกว้างขององค์ประกอบคือความกว้างของกรอบล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
ratio | Number | อัตราส่วนที่จะใช้ปรับความกว้างขององค์ประกอบหน้านี้ตาม |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
เลือกเฉพาะ PageElement
ในงานนำเสนอที่ใช้งานอยู่และนำรายการที่เลือกก่อนหน้านี้ออก เช่นเดียวกับการโทรหา select(replace)
ด้วย true
สคริปต์จะเข้าถึงการเลือกของผู้ใช้ที่เรียกใช้สคริปต์ได้เท่านั้น และในกรณีที่สคริปต์เชื่อมโยงกับงานนำเสนอเท่านั้น
การดำเนินการนี้จะกำหนด Page
ระดับบนสุดของ PageElement
เป็น current page selection
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
เลือก PageElement
ในงานนำเสนอที่ใช้งานอยู่
สคริปต์จะเข้าถึงการเลือกของผู้ใช้ที่เรียกใช้สคริปต์ได้เท่านั้น และในกรณีที่สคริปต์เชื่อมโยงกับงานนำเสนอเท่านั้น
ส่ง true
ไปยังวิธีการนี้เพื่อเลือกเฉพาะ PageElement
และนำการเลือกก่อนหน้านี้ออก ซึ่งจะตั้งค่า Page
ระดับบนสุดของ PageElement
เป็น current page selection
ด้วย
ส่ง false
เพื่อเลือกวัตถุ PageElement
หลายรายการ ออบเจ็กต์ PageElement
ต้องอยู่ใน Page
เดียวกัน
ต้องมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้ขณะเลือกองค์ประกอบของหน้าโดยใช้พารามิเตอร์ false
Page
ระดับบนสุดของออบเจ็กต์PageElement
ต้องเป็นcurrent page selection
- ไม่ควรเลือกออบเจ็กต์
Page
หลายรายการ
วิธีที่แนะนำคือให้เลือก Page
ระดับบนสุดก่อนโดยใช้ Page.selectAsCurrentPage()
แล้วจึงเลือกองค์ประกอบของหน้าในหน้านั้น
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. var pageElements = slide.getPageElements(); for (var i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
replace | Boolean | หากเป็น true รายการที่เลือกจะแทนที่การเลือกก่อนหน้า มิเช่นนั้นระบบจะเพิ่มการเลือกดังกล่าวลงในการเลือกก่อนหน้า |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
ส่งองค์ประกอบของหน้าไปข้างหลังทีละ 1 องค์ประกอบ
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
ส่งองค์ประกอบของหน้าไปด้านหลังของหน้า
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
ตั้งค่าคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า
วิธีการใช้ไม่ได้กับองค์ประกอบ Group
// Set the first page element's alt text description to "new alt text description". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
description | String | สตริงที่จะตั้งคำอธิบายข้อความแสดงแทน |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
height | Number | ความสูงใหม่ขององค์ประกอบหน้านี้ที่จะตั้งค่าเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
left | Number | ตำแหน่งแนวนอนใหม่ที่จะกำหนดเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
ตั้งค่ามุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
angle | Number | มุมหมุนตามเข็มนาฬิกาใหม่ที่จะตั้งเป็นองศา |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
ตั้งชื่อข้อความแสดงแทนขององค์ประกอบหน้า
วิธีการใช้ไม่ได้กับองค์ประกอบ Group
// Set the first page element's alt text title to "new alt text title". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
title | String | สตริงที่จะตั้งชื่อข้อความแสดงแทน |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
top | Number | ตำแหน่งแนวตั้งใหม่ที่จะตั้งเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าด้วยการเปลี่ยนรูปแบบที่ให้ไว้
การอัปเดตการเปลี่ยนรูปแบบของกลุ่มจะเปลี่ยนการเปลี่ยนรูปแบบสัมบูรณ์ขององค์ประกอบของหน้าในกลุ่มนั้น ซึ่งอาจเปลี่ยนแปลงลักษณะที่ปรากฏได้
การอัปเดตการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บที่อยู่ในกลุ่มจะเปลี่ยนแปลงเฉพาะการเปลี่ยนรูปแบบขององค์ประกอบหน้านั้นเท่านั้น และไม่ส่งผลต่อการเปลี่ยนรูปแบบของกลุ่มหรือองค์ประกอบอื่นๆ ของหน้าเว็บในกลุ่ม
ดูรายละเอียดเกี่ยวกับวิธีที่การเปลี่ยนรูปแบบส่งผลต่อลักษณะที่ปรากฏของหน้าองค์ประกอบต่างๆ ได้ที่ getTransform()
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
transform | AffineTransform | การเปลี่ยนรูปแบบที่ตั้งค่าไว้สำหรับองค์ประกอบของหน้านี้ |
รีเทิร์น
PageElement
— องค์ประกอบนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
กำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ใช้ไม่ได้กับบางองค์ประกอบของหน้า หากต้องการทราบว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
width | Number | ความกว้างใหม่ขององค์ประกอบของหน้านี้ที่จะกำหนดเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations