Class Shape

รูปร่าง

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
alignOnPage(alignmentPosition)Shapeจัดแนวองค์ประกอบไปยังตำแหน่งการจัดแนวที่ระบุในหน้า
bringForward()Shapeเลื่อนองค์ประกอบของหน้าไปข้างหน้าในหน้าทีละองค์ประกอบ
bringToFront()Shapeนำองค์ประกอบหน้าไปไว้ด้านหน้าของหน้า
duplicate()PageElementทำซ้ำองค์ประกอบหน้าเว็บ
getAutofit()Autofit|nullแสดง Autofit ของข้อความภายในรูปร่างนี้
getBorder()Borderแสดงผล Border ของรูปร่าง
getConnectionSites()ConnectionSite[]แสดงรายการ ConnectionSite ในองค์ประกอบหน้า หรือรายการที่ว่างเปล่าหากองค์ประกอบหน้า ไม่มีเว็บไซต์ที่เชื่อมต่อ
getContentAlignment()ContentAlignmentแสดง ContentAlignment ของข้อความในรูปร่าง
getDescription()Stringแสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้าเว็บ
getFill()Fillแสดงผล Fill ของรูปร่าง
getHeight()Number|nullรับความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของกรอบล้อมรอบขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
getInherentHeight()Number|nullแสดงผลความสูงโดยธรรมชาติขององค์ประกอบเป็นจุด
getInherentWidth()Number|nullแสดงผลความกว้างโดยธรรมชาติขององค์ประกอบในหน่วยคะแนน
getLeft()Numberแสดงผลตำแหน่งแนวนอนขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของ หน้าเมื่อองค์ประกอบไม่มีการหมุน
getLink()Link|nullแสดงผล Link หรือ null หากไม่มีลิงก์
getObjectId()Stringแสดงรหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้
getPageElementType()PageElementTypeแสดงผลประเภทขององค์ประกอบหน้าเว็บ ซึ่งแสดงเป็น PageElementType enum
getParentGroup()Group|nullแสดงกลุ่มที่องค์ประกอบของหน้านี้เป็นของ หรือ null หากองค์ประกอบไม่ได้อยู่ในกลุ่ม
getParentPage()Pageแสดงหน้าที่องค์ประกอบของหน้านี้อยู่
getParentPlaceholder()PageElement|nullแสดงผลองค์ประกอบหน้าหลักของตัวยึดตำแหน่ง
getPlaceholderIndex()Integer|nullแสดงผลดัชนีตัวยึดตำแหน่งของรูปร่าง
getPlaceholderType()PlaceholderTypeแสดงผลประเภทตัวยึดตำแหน่งของรูปร่าง หรือ PlaceholderType.NONE หากรูปร่างไม่ใช่ ตัวยึดตำแหน่ง
getRotation()Numberแสดงผลมุมการหมุนตามเข็มนาฬิการอบจุดกึ่งกลางขององค์ประกอบเป็นองศา โดยที่ 0 องศา หมายถึงไม่มีการหมุน
getShapeType()ShapeTypeแสดงผลประเภทของรูปร่าง
getText()TextRangeแสดงเนื้อหาข้อความของรูปร่าง
getTitle()Stringแสดงชื่อข้อความแสดงแทนขององค์ประกอบหน้าเว็บ
getTop()Numberรับตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมบนซ้ายของหน้า เมื่อองค์ประกอบไม่มีการหมุน
getTransform()AffineTransformแสดงผลการเปลี่ยนรูปขององค์ประกอบหน้า
getWidth()Number|nullแสดงผลความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของกรอบล้อมรอบขององค์ประกอบเมื่อ องค์ประกอบไม่มีการหมุน
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 ที่ระบุโดยใช้ดัชนีแบบอิงตาม 0 ของสไลด์
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)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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|null — การปรับข้อความให้พอดีกับรูปร่างนี้โดยอัตโนมัติ

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

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

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

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

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

getInherentHeight()

แสดงผลความสูงโดยธรรมชาติขององค์ประกอบเป็นจุด

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

รีเทิร์น

Number|null — ความสูงโดยธรรมชาติขององค์ประกอบหน้าในหน่วยคะแนน หรือ null หากองค์ประกอบหน้าไม่มีความสูง

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

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

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

getInherentWidth()

แสดงผลความกว้างโดยธรรมชาติขององค์ประกอบในหน่วยคะแนน

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

รีเทิร์น

Number|null — ความกว้างโดยธรรมชาติขององค์ประกอบหน้าในหน่วยคะแนน หรือ 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 หากไม่มีลิงก์ 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

รีเทิร์น

Link|null — Link หรือ null หากไม่มีลิงก์

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

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

แสดงผลประเภทขององค์ประกอบหน้าเว็บ ซึ่งแสดงเป็น PageElementType enum

รีเทิร์น

PageElementType — ประเภทขององค์ประกอบหน้าเว็บ

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

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

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

getParentGroup()

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

รีเทิร์น

Group|null — กลุ่มที่องค์ประกอบของหน้านี้เป็นของ หรือ 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 — องค์ประกอบหน้าหลักของตัวยึดตำแหน่งรูปร่างนี้ หรือ null หากรูปร่างนี้ไม่ใช่ตัวยึดตำแหน่งหรือไม่มีองค์ประกอบหลัก

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

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

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

getPlaceholderIndex()

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

รีเทิร์น

Integer|null — ดัชนีตัวยึดตำแหน่งของรูปร่างนี้ หรือ 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 — ความกว้างโดยธรรมชาติขององค์ประกอบหน้าในหน่วยคะแนน หรือ null หากองค์ประกอบหน้าไม่มีความกว้าง

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

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

ตัวอย่างเช่น หากต้องการย้ายองค์ประกอบของหน้าไปทางซ้าย 36 พอยต์ ให้ทำดังนี้ 

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

นอกจากนี้ คุณยังแทนที่การเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วย setTransform(transform) ได้ด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 ออก 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replaceWithImage(blobSource)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image - Image ที่แทนที่รูปร่าง

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

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

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

replaceWithImage(blobSource, crop)

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image - Image ที่แทนที่รูปร่าง

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image - Image ที่แทนที่รูปร่าง

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

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

พารามิเตอร์

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

รีเทิร์น

Image - Image ที่แทนที่รูปร่าง

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

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

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

replaceWithSheetsChart(sourceChart)

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceWithSheetsChartAsImage(sourceChart)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

scaleHeight(ratio)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

scaleWidth(ratio)

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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() จากนั้นเลือกองค์ประกอบของหน้าในหน้านั้น 

const 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.
const pageElements = slide.getPageElements();
for (let 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 องค์ประกอบ

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

รีเทิร์น

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 ของข้อความในรูปร่าง

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setHeight(height)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setLeft(left)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setLinkSlide(slideIndex)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
slideIndexIntegerดัชนีแบบ 0 ของสไลด์

รีเทิร์น

Link - Link ที่ตั้งค่าไว้

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

พารามิเตอร์

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

รีเทิร์น

Link - Link ที่ตั้งค่าไว้

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
slidePositionSlidePositionSlidePosition ที่เกี่ยวข้อง

รีเทิร์น

Link - Link ที่ตั้งค่าไว้

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

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

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

setLinkUrl(url)

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

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringสตริง URL

รีเทิร์น

Link - Link ที่ตั้งค่าไว้

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

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

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

setRotation(angle)

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTop(top)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTransform(transform)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setWidth(width)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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