Class Shape

รูปร่าง

PageElement แสดงรูปร่างทั่วไปที่ไม่มีการจัดประเภทที่เจาะจงมากกว่า ประกอบด้วยกล่องข้อความ สี่เหลี่ยมผืนผ้า และรูปร่างที่กำหนดไว้ล่วงหน้าอื่นๆ

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
alignOnPage(alignmentPosition)Shapeจัดองค์ประกอบให้อยู่ในตําแหน่งการจัดข้อความที่ระบุในหน้า
bringForward()Shapeนำองค์ประกอบของหน้ามาไว้ด้านหน้าทีละองค์ประกอบ
bringToFront()Shapeนำองค์ประกอบของหน้ามาไว้ที่ด้านบนของหน้า
duplicate()PageElementทำซ้ำองค์ประกอบของหน้า
getAutofit()Autofitแสดงผล Autofit ของข้อความภายในรูปร่างนี้
getBorder()Borderแสดง Border ของรูปร่าง
getConnectionSites()ConnectionSite[]แสดงรายการ ConnectionSite ในองค์ประกอบของหน้า หรือรายการที่ว่างเปล่าหากองค์ประกอบของหน้าไม่มีเว็บไซต์การเชื่อมต่อ
getContentAlignment()ContentAlignmentแสดงผล ContentAlignment ของข้อความในรูปร่าง
getDescription()Stringแสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า
getFill()Fillแสดง Fill ของรูปร่าง
getHeight()Numberดูความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
getInherentHeight()Numberแสดงผลความสูงปกติขององค์ประกอบเป็นจุด
getInherentWidth()Numberแสดงผลความกว้างตามปกติขององค์ประกอบเป็นจุด
getLeft()Numberแสดงตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
getLink()Linkแสดงผล Link หรือ null หากไม่มีลิงก์
getObjectId()Stringแสดงรหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้
getPageElementType()PageElementTypeแสดงผลประเภทองค์ประกอบของหน้า ซึ่งแสดงเป็น enum PageElementType
getParentGroup()Groupแสดงผลกลุ่มองค์ประกอบของหน้านี้ หรือ null หากองค์ประกอบไม่ได้อยู่ในกลุ่ม
getParentPage()Pageแสดงหน้าที่มีองค์ประกอบของหน้านี้อยู่
getParentPlaceholder()PageElementแสดงผลองค์ประกอบหน้าระดับบนสุดของตัวยึดตำแหน่ง
getPlaceholderIndex()Integerแสดงผลดัชนีตัวยึดตำแหน่งของรูปร่าง
getPlaceholderType()PlaceholderTypeแสดงผลประเภทตัวยึดตำแหน่งของรูปร่าง หรือ PlaceholderType.NONE หากรูปร่างไม่ใช่ตัวยึดตำแหน่ง
getRotation()Numberแสดงมุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา โดยที่ 0 องศาหมายถึงไม่มีการหมุน
getShapeType()ShapeTypeแสดงประเภทของรูปร่าง
getText()TextRangeแสดงผลเนื้อหาข้อความของรูปร่าง
getTitle()Stringแสดงชื่อข้อความแสดงแทนขององค์ประกอบหน้า
getTop()Numberดึงตำแหน่งแนวตั้งขององค์ประกอบเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
getTransform()AffineTransformแสดงการเปลี่ยนรูปแบบขององค์ประกอบหน้า
getWidth()Numberแสดงผลความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
preconcatenateTransform(transform)Shapeเชื่อมต่อการแปลงที่ระบุล่วงหน้ากับการเปลี่ยนรูปแบบที่มีอยู่ขององค์ประกอบหน้า
remove()voidนำองค์ประกอบของหน้าออก
removeLink()voidนำ Link ออก
replaceWithImage(blobSource)Imageแทนที่รูปร่างนี้ด้วยรูปภาพที่ BlobSource ให้ไว้
replaceWithImage(blobSource, crop)Imageแทนที่รูปร่างนี้ด้วยรูปภาพที่ BlobSource ให้ไว้
replaceWithImage(imageUrl)Imageแทนที่รูปร่างนี้ด้วยรูปภาพ
replaceWithImage(imageUrl, crop)Imageแทนที่รูปร่างนี้ด้วยรูปภาพ
replaceWithSheetsChart(sourceChart)SheetsChartแทนที่รูปร่างนี้ด้วยแผนภูมิ Google ชีต
replaceWithSheetsChartAsImage(sourceChart)Imageแทนที่รูปร่างนี้ด้วยรูปภาพแผนภูมิ Google ชีต
scaleHeight(ratio)Shapeปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ
scaleWidth(ratio)Shapeปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ
select()voidเลือกเฉพาะ PageElement ในงานนำเสนอที่ใช้งานอยู่และนำรายการที่เลือกก่อนหน้านี้ออก
select(replace)voidเลือก PageElement ในงานนำเสนอที่ใช้งานอยู่
sendBackward()Shapeส่งองค์ประกอบของหน้าไปข้างหลังทีละ 1 องค์ประกอบ
sendToBack()Shapeส่งองค์ประกอบของหน้าไปด้านหลังของหน้า
setContentAlignment(contentAlignment)Shapeตั้งค่า ContentAlignment ของข้อความในรูปร่าง
setDescription(description)Shapeตั้งค่าคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า
setHeight(height)Shapeกำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งก็คือความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
setLeft(left)Shapeกำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
setLinkSlide(slideIndex)Linkตั้งค่า Link เป็น Slide ที่กำหนดโดยใช้ดัชนีแบบศูนย์ของสไลด์
setLinkSlide(slide)Linkตั้งค่า Link ให้กับ Slide ที่กำหนด โดยลิงก์จะกำหนดตามรหัสสไลด์ที่ระบุ
setLinkSlide(slidePosition)Linkตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ตำแหน่งสัมพัทธ์ของสไลด์
setLinkUrl(url)Linkตั้งค่า Link เป็นสตริง URL ที่ไม่ว่าง
setRotation(angle)Shapeตั้งค่ามุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา
setTitle(title)Shapeตั้งชื่อข้อความแสดงแทนขององค์ประกอบหน้า
setTop(top)Shapeกำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
setTransform(transform)Shapeตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าด้วยการเปลี่ยนรูปแบบที่ให้ไว้
setWidth(width)Shapeกำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งก็คือความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน

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

alignOnPage(alignmentPosition)

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน


bringForward()

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

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

bringToFront()

นำองค์ประกอบของหน้ามาไว้ที่ด้านบนของหน้า

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

getAutofit()

แสดงผล Autofit ของข้อความภายในรูปร่างนี้ นี่คือ null หากรูปร่างไม่อนุญาตให้มีข้อความ

รีเทิร์น

Autofit — การปรับข้อความให้พอดีโดยอัตโนมัติภายในรูปร่างนี้

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

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

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

getBorder()

แสดง Border ของรูปร่าง

รีเทิร์น

Border — การตั้งค่าเส้นขอบของรูปร่างนี้

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

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

getContentAlignment()

แสดงผล ContentAlignment ของข้อความในรูปร่าง

รีเทิร์น

ContentAlignment — การจัดข้อความภายในรูปร่างนี้

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

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

getFill()

แสดง Fill ของรูปร่าง

รีเทิร์น

Fill — การตั้งค่าการเติมสีของรูปร่างนี้

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

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

แสดงผล Link หรือ null หากไม่มีลิงก์

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

รีเทิร์น

Link

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

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

getParentPlaceholder()

แสดงผลองค์ประกอบหน้าระดับบนสุดของตัวยึดตำแหน่ง แสดงผล null หากรูปร่างไม่ใช่ตัวยึดตำแหน่งหรือไม่มีระดับบนสุด

รีเทิร์น

PageElement — องค์ประกอบหน้าระดับบนสุดของตัวยึดตำแหน่งรูปร่างนี้ หรือ null หากรูปร่างนี้ไม่ใช่ตัวยึดตำแหน่งหรือไม่มีระดับบนสุด

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

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

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

getPlaceholderIndex()

แสดงผลดัชนีตัวยึดตำแหน่งของรูปร่าง หากมีอินสแตนซ์ที่มีประเภทตัวยึดตำแหน่งเดียวกันอย่างน้อย 2 รายการอยู่ในหน้าเดียวกัน อินสแตนซ์แต่ละรายการจะมีค่าดัชนีที่ไม่ซ้ำกัน แสดงผล null หากรูปร่างไม่ใช่ตัวยึดตำแหน่ง

รีเทิร์น

Integer — ดัชนีตัวยึดตำแหน่งของรูปร่างนี้ หรือ null ถ้ารูปร่างไม่ใช่ตัวยึดตำแหน่ง

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

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

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

getPlaceholderType()

แสดงผลประเภทตัวยึดตำแหน่งของรูปร่าง หรือ PlaceholderType.NONE หากรูปร่างไม่ใช่ตัวยึดตำแหน่ง

รีเทิร์น

PlaceholderType — ประเภทตัวยึดตำแหน่งของรูปร่างนี้

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

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

getShapeType()

แสดงประเภทของรูปร่าง

รีเทิร์น

ShapeType — ประเภทของรูปร่างนี้


getText()

แสดงผลเนื้อหาข้อความของรูปร่าง

ข้อความในรูปร่างจะยุติด้วยอักขระขึ้นบรรทัดใหม่เสมอ

รีเทิร์น

TextRange — เนื้อหาข้อความของรูปร่างนี้

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

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

นำ Link ออก

shape.removeLink();

replaceWithImage(blobSource)

แทนที่รูปร่างนี้ด้วยรูปภาพที่ BlobSource ให้ไว้

ระบบจะดึงข้อมูลรูปภาพจาก BlobSource ที่ให้ไว้ 1 ครั้ง ณ เวลาที่แทรก และระบบจะจัดเก็บสำเนาไว้เพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดเล็กกว่า 50 MB ต้องไม่ใหญ่กว่า 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF

ในการรักษาอัตราส่วนของรูปภาพ ระบบจะปรับขนาดรูปภาพและจัดกึ่งกลางตามขนาดของรูปร่างที่มีอยู่

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobSourceBlobSourceข้อมูลรูปภาพ

รีเทิร์น

ImageImage ที่แทนที่รูปร่าง

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

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

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

replaceWithImage(blobSource, crop)

แทนที่รูปร่างนี้ด้วยรูปภาพที่ BlobSource ให้ไว้

การแทรกรูปภาพจะดึงข้อมูลจาก BlobSource 1 ครั้งและจะจัดเก็บสำเนาเพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB ห้ามเกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobSourceBlobSourceข้อมูลรูปภาพ
cropBooleanหากเป็น true ให้ครอบตัดรูปภาพให้พอดีกับขนาดของรูปร่างที่มีอยู่ มิเช่นนั้น รูปภาพจะมีการปรับขนาดและอยู่ตรงกลาง

รีเทิร์น

ImageImage ที่แทนที่รูปร่าง

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

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

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

replaceWithImage(imageUrl)

แทนที่รูปร่างนี้ด้วยรูปภาพ

การแทรกรูปภาพจะดึงข้อมูลจาก URL เพียงครั้งเดียวและจะเก็บสำเนาไว้เพื่อแสดงในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB และต้องไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีขนาดไม่เกิน 2 KB ระบบจะบันทึก URL ไว้กับรูปภาพและแสดงผ่าน Image.getSourceUrl()

ในการรักษาอัตราส่วนของรูปภาพ ระบบจะปรับขนาดรูปภาพและจัดกึ่งกลางตามขนาดของรูปร่างที่มีอยู่

พารามิเตอร์

ชื่อTypeคำอธิบาย
imageUrlStringURL ของรูปภาพที่ใช้ดาวน์โหลดรูปภาพ

รีเทิร์น

ImageImage ที่แทนที่รูปร่าง

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

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

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

replaceWithImage(imageUrl, crop)

แทนที่รูปร่างนี้ด้วยรูปภาพ

การแทรกรูปภาพจะดึงข้อมูลจาก URL เพียงครั้งเดียวและจะเก็บสำเนาไว้เพื่อแสดงในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB และต้องไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

URL ที่ระบุต้องมีขนาดไม่เกิน 2 KB ระบบบันทึก URL นั้นไว้กับรูปภาพและ แสดงผ่าน Image.getSourceUrl()

พารามิเตอร์

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

รีเทิร์น

ImageImage ที่แทนที่รูปร่าง

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

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

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

replaceWithSheetsChart(sourceChart)

แทนที่รูปร่างนี้ด้วยแผนภูมิ Google ชีต

แผนภูมินี้ลิงก์กับแผนภูมิต้นฉบับใน Google ชีต ซึ่งอัปเดตได้ ผู้ทำงานร่วมกันคนอื่นๆ จะเห็นลิงก์ไปยังสเปรดชีตต้นทาง

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่แทนที่รูปร่าง

รีเทิร์น

SheetsChart — แผนภูมิที่แทนที่รูปร่าง

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

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

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

replaceWithSheetsChartAsImage(sourceChart)

แทนที่รูปร่างนี้ด้วยรูปภาพแผนภูมิ Google ชีต

เพื่อรักษาอัตราส่วนของแผนภูมิใน Google ชีต รูปภาพแผนภูมิจะถูกปรับขนาดและจัดกึ่งกลางตามขนาดของรูปร่างที่มีอยู่

รูปภาพของแผนภูมิไม่ได้ลิงก์กับแผนภูมิต้นฉบับใน Google ชีต

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่แทนที่รูปร่าง

รีเทิร์น

Image — รูปภาพของแผนภูมิที่แทนที่รูปร่าง

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

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

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

scaleHeight(ratio)

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

scaleWidth(ratio)

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

พารามิเตอร์

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

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

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

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

sendBackward()

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

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

sendToBack()

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

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

setContentAlignment(contentAlignment)

ตั้งค่า ContentAlignment ของข้อความในรูปร่าง

วิธีนี้จะปิดใช้งานคุณสมบัติการปรับข้อความให้พอดีโดยอัตโนมัติในรูปร่างที่อัปเดต

พารามิเตอร์

ชื่อTypeคำอธิบาย
contentAlignmentContentAlignmentการจัดข้อความที่จะตั้งค่า

รีเทิร์น

Shape — รูปร่างนี้สำหรับการทำเชน

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

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

รีเทิร์น

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

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

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

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

setHeight(height)

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

setLeft(left)

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

setLinkSlide(slideIndex)

ตั้งค่า Link เป็น Slide ที่กำหนดโดยใช้ดัชนีแบบศูนย์ของสไลด์

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

พารามิเตอร์

ชื่อTypeคำอธิบาย
slideIndexIntegerดัชนีฐาน 0 ของสไลด์

รีเทิร์น

LinkLink ที่ตั้งค่าไว้

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

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

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

setLinkSlide(slide)

ตั้งค่า Link ให้กับ Slide ที่กำหนด โดยลิงก์จะกำหนดตามรหัสสไลด์ที่ระบุ

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

พารามิเตอร์

ชื่อTypeคำอธิบาย
slideSlideSlide ที่จะลิงก์

รีเทิร์น

LinkLink ที่ตั้งค่าไว้

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

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

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

setLinkSlide(slidePosition)

ตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ตำแหน่งสัมพัทธ์ของสไลด์

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

พารามิเตอร์

ชื่อTypeคำอธิบาย
slidePositionSlidePositionSlidePosition แบบสัมพัทธ์

รีเทิร์น

LinkLink ที่ตั้งค่าไว้

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

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

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

setLinkUrl(url)

ตั้งค่า Link เป็นสตริง URL ที่ไม่ว่าง

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

พารามิเตอร์

ชื่อTypeคำอธิบาย
urlStringสตริง URL

รีเทิร์น

LinkLink ที่ตั้งค่าไว้

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

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

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

setRotation(angle)

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

รีเทิร์น

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

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

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

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

setTop(top)

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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

setTransform(transform)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบนี้สำหรับการทำเชน

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

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

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

setWidth(width)

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

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

พารามิเตอร์

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

รีเทิร์น

Shape — องค์ประกอบของหน้านี้สำหรับการทำเชน

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

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

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