องค์ประกอบภาพที่แสดงผลในหน้าเว็บ
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
alignOnPage(alignmentPosition) | PageElement | จัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ |
asGroup() | Group | แสดงผลองค์ประกอบของหน้าเป็นกลุ่ม |
asImage() | Image | แสดงผลองค์ประกอบของหน้าเป็นรูปภาพ |
asLine() | Line | แสดงผลองค์ประกอบของหน้าเป็นเส้น |
asShape() | Shape | แสดงผลองค์ประกอบของหน้าเป็นรูปร่าง |
asSheetsChart() | SheetsChart | แสดงผลองค์ประกอบของหน้าเป็นแผนภูมิที่ลิงก์ซึ่งฝังจาก Google ชีต |
asSpeakerSpotlight() | SpeakerSpotlight | แสดงผลองค์ประกอบของหน้าเป็นวิดีโอสปอตไลท์ผู้บรรยาย |
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)
จัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignmentPosition | AlignmentPosition | ตำแหน่งที่จะจัดองค์ประกอบของหน้านี้ให้ในหน้า |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
asGroup()
asImage()
asLine()
asShape()
asSheetsChart()
แสดงผลองค์ประกอบของหน้าเป็นแผนภูมิที่ลิงก์ซึ่งฝังจาก Google ชีต
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้าที่เป็นแผนภูมิ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asSpeakerSpotlight()
แสดงผลองค์ประกอบของหน้าเป็นวิดีโอสปอตไลท์ผู้บรรยาย
const pageElement = slide.getPageElements()[0]; pageElement.asSpeakerSpotlight();
รีเทิร์น
SpeakerSpotlight
— องค์ประกอบของหน้าที่เป็นวิดีโอสปอตไลท์ผู้บรรยาย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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)
ได้ด้วย
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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)
ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ ความสูงขององค์ประกอบคือความสูงของช่องล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
ratio | Number | อัตราส่วนที่ใช้ปรับขนาดความสูงขององค์ประกอบหน้านี้ |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ ความกว้างขององค์ประกอบคือความกว้างของกล่องขอบเขตเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
description | String | สตริงที่จะตั้งคำอธิบายข้อความแสดงแทน |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องล้อมรอบองค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
height | Number | ความสูงใหม่ขององค์ประกอบหน้าเว็บนี้ที่จะกำหนดเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
left | Number | ตำแหน่งแนวนอนใหม่ในหน่วยจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
ตั้งค่ามุมหมุนตามเข็มนาฬิกาขององค์ประกอบจากจุดศูนย์กลาง หน่วยเป็นองศา
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | สตริงที่จะใช้ตั้งชื่อข้อความแสดงแทน |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Number | ตำแหน่งแนวตั้งใหม่ที่จะตั้งค่า หน่วยเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วยการเปลี่ยนรูปแบบที่ระบุ
การอัปเดตการเปลี่ยนรูปแบบของกลุ่มจะเปลี่ยนการเปลี่ยนแปลงแบบสัมบูรณ์ขององค์ประกอบหน้าในกลุ่มนั้น ซึ่งอาจเปลี่ยนรูปลักษณ์ได้
การอัปเดตการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บที่อยู่ในกลุ่มจะเปลี่ยนการเปลี่ยนรูปแบบขององค์ประกอบหน้านั้นเท่านั้น โดยจะไม่ส่งผลต่อการแปลงของกลุ่มหรือองค์ประกอบของหน้าอื่นๆ ในกลุ่มดังกล่าว
ดูรายละเอียดเกี่ยวกับผลของการเปลี่ยนรูปแบบต่อรูปลักษณ์ขององค์ประกอบหน้าได้ที่ getTransform()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
transform | AffineTransform | การเปลี่ยนรูปแบบที่ตั้งไว้สําหรับองค์ประกอบของหน้านี้ |
รีเทิร์น
PageElement
— องค์ประกอบนี้สำหรับการทำห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
กำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
width | Number | ความกว้างใหม่ขององค์ประกอบของหน้านี้ที่จะตั้งค่า หน่วยเป็นจุด |
รีเทิร์น
PageElement
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations