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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

นำ Link ออก 

shape.removeLink();

replaceWithImage(blobSource)

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

ระบบจะดึงรูปภาพจาก BlobSource ที่ให้ไว้ครั้งเดียวเมื่อแทรกและคัดลอก เพื่อแสดงผลภายในงานนำเสนอ รูปภาพต้องมีขนาดไม่เกิน 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);

พารามิเตอร์

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 ที่ระบุต้องมีขนาดไม่เกิน 2kB ระบบจะบันทึก 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 ชีต ซึ่งช่วยให้อัปเดตได้ อื่นๆ ผู้ทำงานร่วมกันจะเห็นลิงก์ไปยังสเปรดชีตต้นทาง 

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

พารามิเตอร์

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

พารามิเตอร์

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

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 องค์ประกอบ

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

รีเทิร์น

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".
var 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.
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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
shape.setLinkSlide(SlideApp.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.
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".
var 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