Class Group

กลุ่ม

คอลเล็กชัน PageElement รวมกันเป็นหน่วยเดียว

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
alignOnPage(alignmentPosition)Groupจัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ
bringForward()Groupนำองค์ประกอบของหน้าไปข้างหน้าทีละองค์ประกอบ
bringToFront()Groupนำองค์ประกอบของหน้าไปไว้ด้านหน้าสุด
duplicate()PageElementทําซ้ำองค์ประกอบของหน้า
getChildren()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)Groupเชื่อมโยงการแปลงที่ระบุล่วงหน้ากับการแปลงที่มีอยู่ขององค์ประกอบหน้าเว็บ
remove()voidนำองค์ประกอบของหน้าออก
scaleHeight(ratio)Groupปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ
scaleWidth(ratio)Groupปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ
select()voidเลือกเฉพาะ PageElement ในงานนำเสนอที่ใช้งานอยู่และนำรายการก่อนหน้าออก มากมาย
select(replace)voidเลือก PageElement ในงานนำเสนอที่ใช้งานอยู่
sendBackward()Groupส่งองค์ประกอบหน้าไปข้างหลังในหน้าโดย 1 องค์ประกอบ
sendToBack()Groupส่งองค์ประกอบของหน้าไปด้านหลังของหน้า
setDescription(description)Groupตั้งค่าคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า
setHeight(height)Groupกำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องขอบเขตขององค์ประกอบเมื่อ ไม่มีการหมุน
setLeft(left)Groupกำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนขององค์ประกอบ เมื่อองค์ประกอบไม่มีการหมุน
setRotation(angle)Groupตั้งค่ามุมหมุนตามเข็มนาฬิกาขององค์ประกอบจากจุดศูนย์กลาง หน่วยเป็นองศา
setTitle(title)Groupตั้งชื่อข้อความแสดงแทนขององค์ประกอบหน้า
setTop(top)Groupกำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้า เมื่อองค์ประกอบไม่มีการหมุน
setTransform(transform)Groupตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วยการแปลงที่ระบุ
setWidth(width)Groupตั้งค่าความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อ ไม่มีการหมุน
ungroup()voidแยกองค์ประกอบของกลุ่มออก

เอกสารโดยละเอียด

alignOnPage(alignmentPosition)

จัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alignmentPositionAlignmentPositionตำแหน่งที่จะจัดองค์ประกอบของหน้านี้ให้ในหน้า

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

bringForward()

นำองค์ประกอบของหน้าไปข้างหน้าทีละองค์ประกอบ

องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

bringToFront()

นำองค์ประกอบของหน้าไปไว้ด้านหน้าสุด

องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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

getChildren()

รับคอลเล็กชันขององค์ประกอบของหน้าเว็บในกลุ่ม ขนาดต่ำสุดของกลุ่มคือ 2

รีเทิร์น

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()

แสดงหน้าที่แสดงองค์ประกอบของหน้านี้

รีเทิร์น

Page — หน้าที่มีองค์ประกอบนี้

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

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()

รับการเปลี่ยนรูปแบบองค์ประกอบของหน้า

การเปลี่ยนรูปแบบเริ่มต้นสำหรับ Group ที่สร้างขึ้นใหม่จะเป็นการแปลงข้อมูลประจำตัวเสมอ ดังนี้ พารามิเตอร์มาตราส่วน 1.0 และพารามิเตอร์แบบเฉือนและแปลค่า 0.0

รีเทิร์น

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) ได้ด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
transformAffineTransformการเปลี่ยนรูปแบบเพื่อเชื่อมไปยังการเปลี่ยนรูปแบบขององค์ประกอบในหน้านี้ล่วงหน้า

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

นำองค์ประกอบของหน้าออก

หากหลังจากการดำเนินการนำออก Group มีองค์ประกอบของหน้าเว็บเพียงรายการเดียวหรือไม่มีเลย กลุ่มนั้นถูกนำออกด้วย

หากนำตัวยึดตำแหน่ง PageElement ออกจากต้นแบบหรือเลย์เอาต์ใดๆ ก็ตามการรับค่าที่ว่างเปล่า ตัวยึดตำแหน่งจะถูกนำออกด้วย

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleHeight(ratio)

ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ ความสูงขององค์ประกอบคือความสูงขององค์ประกอบ กรอบล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน

วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ เพื่อดูว่าองค์ประกอบใดของหน้า โดยใช้วิธีนี้ได้ โปรดดูที่ ขีดจำกัดด้านขนาดและการวางตำแหน่ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
ratioNumberอัตราส่วนที่ใช้ปรับขนาดความสูงขององค์ประกอบหน้านี้

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleWidth(ratio)

ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ ความกว้างขององค์ประกอบคือความกว้างขององค์ประกอบ กรอบล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน

วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ เพื่อดูว่าองค์ประกอบใดของหน้า โดยใช้วิธีนี้ได้ โปรดดูที่ ขีดจำกัดด้านขนาดและการวางตำแหน่ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
ratioNumberอัตราส่วนที่ใช้ปรับขนาดความกว้างขององค์ประกอบหน้านี้

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 พารามิเตอร์:

  1. Page ระดับบนของออบเจ็กต์ PageElement ต้องเป็น current page selection
  2. ไม่ควรเลือกออบเจ็กต์ 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);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
replaceBooleanหากเป็น true การเลือกดังกล่าวจะแทนที่รายการที่เลือกก่อนหน้า มิฉะนั้น จะถูกเพิ่มลงในการเลือกก่อนหน้า

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendBackward()

ส่งองค์ประกอบหน้าไปข้างหลังในหน้าโดย 1 องค์ประกอบ

องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendToBack()

ส่งองค์ประกอบของหน้าไปด้านหลังของหน้า

องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
descriptionStringสตริงที่จะตั้งคำอธิบายข้อความแสดงแทน

รีเทิร์น

Group — องค์ประกอบของหน้านี้

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setHeight(height)

กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องขอบเขตขององค์ประกอบเมื่อ ไม่มีการหมุน

วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ เพื่อดูว่าองค์ประกอบใดของหน้า โดยใช้วิธีนี้ได้ โปรดดูที่ ขีดจำกัดด้านขนาดและการวางตำแหน่ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
heightNumberความสูงใหม่ขององค์ประกอบหน้าเว็บนี้ที่จะกำหนดเป็นจุด

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLeft(left)

กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนขององค์ประกอบ เมื่อองค์ประกอบไม่มีการหมุน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
leftNumberตำแหน่งแนวนอนใหม่ในหน่วยจุด

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setRotation(angle)

ตั้งค่ามุมหมุนตามเข็มนาฬิกาขององค์ประกอบจากจุดศูนย์กลาง หน่วยเป็นองศา

วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ เพื่อดูว่าองค์ประกอบใดของหน้า โดยใช้วิธีนี้ได้ โปรดดูที่ ขีดจำกัดด้านขนาดและการวางตำแหน่ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
angleNumberมุมการหมุนตามเข็มนาฬิกาใหม่ที่จะตั้งค่า หน่วยเป็นองศา

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringสตริงที่จะใช้ตั้งชื่อข้อความแสดงแทน

รีเทิร์น

Group — องค์ประกอบของหน้านี้

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTop(top)

กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้า เมื่อองค์ประกอบไม่มีการหมุน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
topNumberตำแหน่งแนวตั้งใหม่ที่จะตั้งค่า หน่วยเป็นจุด

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTransform(transform)

ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วยการแปลงที่ระบุ

การอัปเดตการเปลี่ยนรูปแบบของกลุ่มจะเปลี่ยนการเปลี่ยนแปลงแบบสัมบูรณ์ขององค์ประกอบหน้าใน กลุ่มดังกล่าว ซึ่งอาจเปลี่ยนลักษณะที่ปรากฏได้

การอัปเดตการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บที่อยู่ในกลุ่มจะเปลี่ยนการเปลี่ยนรูปแบบของ องค์ประกอบของหน้านั้น จะไม่ส่งผลต่อการแปลงของกลุ่มหรือองค์ประกอบอื่นๆ ของหน้าเว็บใน กลุ่ม

ดูรายละเอียดเกี่ยวกับผลของการเปลี่ยนรูปแบบต่อรูปลักษณ์ขององค์ประกอบหน้าได้ที่ getTransform()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
transformAffineTransformการเปลี่ยนรูปแบบที่ตั้งไว้สําหรับองค์ประกอบของหน้านี้

รีเทิร์น

Group — องค์ประกอบนี้สำหรับการทำห่วงโซ่

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setWidth(width)

ตั้งค่าความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อ ไม่มีการหมุน

วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ เพื่อดูว่าองค์ประกอบใดของหน้า โดยใช้วิธีนี้ได้ โปรดดูที่ ขีดจำกัดด้านขนาดและการวางตำแหน่ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
widthNumberความกว้างใหม่ขององค์ประกอบของหน้านี้ที่จะตั้งค่า หน่วยเป็นจุด

รีเทิร์น

Group — องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

ungroup()

เลิกจัดกลุ่มองค์ประกอบของกลุ่ม

กลุ่มจะถูกนำออก

ไม่สามารถยกเลิกการจัดกลุ่มที่อยู่ในกลุ่มอื่นได้

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

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations