Class Image

รูปภาพ

PageElement ที่แสดงรูปภาพ

เมธอด

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

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

alignOnPage(alignmentPosition)

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

bringForward()

เลื่อนองค์ประกอบหน้าเว็บไปข้างหน้าทีละองค์ประกอบ

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

bringToFront()

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

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

getAs(contentType)

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ วิธีนี้จะเพิ่มนามสกุลที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม ระบบจะถือว่าส่วนชื่อไฟล์ที่อยู่หลังจุดสุดท้าย (หากมี) คือนามสกุลที่มีอยู่ซึ่งควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" จะเปลี่ยนเป็น "ShoppingList.12.25.pdf"

หากต้องการดูโควต้า Conversion รายวัน โปรดดูโควต้าสําหรับบริการของ Google โดเมน Google Workspace ที่สร้างขึ้นใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดขึ้นชั่วคราว

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลง สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG จะใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ก็ได้ สำหรับเอกสาร Google เอกสาร จะใช้ 'text/markdown' ก็ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลเป็น Blob

getBlob()

แสดงผลข้อมูลภายในรูปภาพนี้เป็น Blob

รีเทิร์น

Blob — ข้อมูลรูปภาพในรูปแบบ Blob

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

getContentUrl()

รับ URL ของรูปภาพ

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

รีเทิร์น

String

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

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

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

getDescription()

แสดงผลคําอธิบายข้อความแสดงแทนขององค์ประกอบหน้า ระบบจะรวมคำอธิบายเข้ากับชื่อเพื่อแสดงและอ่านข้อความแสดงแทน

รีเทิร์น

String — คำอธิบายข้อความแสดงแทนขององค์ประกอบหน้าเว็บ

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

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

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

getHeight()

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

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

รีเทิร์น

Number — ความสูงตามปกติขององค์ประกอบหน้าเว็บเป็นจุด หรือ null หากองค์ประกอบหน้าเว็บไม่มีความสูง

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

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

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

getInherentHeight()

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

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

รีเทิร์น

Number — ความสูงตามปกติขององค์ประกอบหน้าเว็บเป็นจุด หรือ null หากองค์ประกอบหน้าเว็บไม่มีความสูง

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

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

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

getInherentWidth()

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

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

รีเทิร์น

Number — ความกว้างโดยธรรมชาติขององค์ประกอบหน้าเว็บเป็นจุด หรือ null หากองค์ประกอบหน้าเว็บไม่มีความกว้าง

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

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

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

getLeft()

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

รีเทิร์น

Number — ตำแหน่งแนวนอนขององค์ประกอบนี้ในจุดจากมุมซ้ายบนของหน้า

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

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

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

แสดง 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 — 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

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

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

getSourceUrl()

รับ URL แหล่งที่มาของรูปภาพ (หากมี)

เมื่อแทรกรูปภาพด้วย URL ระบบจะแสดง URL ที่ระบุระหว่างการแทรกรูปภาพ

รีเทิร์น

String — URL ของรูปภาพหรือ null หากรูปภาพไม่มี URL แหล่งที่มา

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

replace(blobSource)

แทนที่รูปภาพนี้ด้วยรูปภาพที่อธิบายโดยออบเจ็กต์ BlobSource

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

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

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

พารามิเตอร์

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

รีเทิร์น

Image — Image นี้หลังจากเปลี่ยนทดแทน

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

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

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

replace(blobSource, crop)

แทนที่รูปภาพนี้ด้วยรูปภาพที่อธิบายโดยออบเจ็กต์ Image โดยอาจครอบตัดรูปภาพให้พอดี

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

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

พารามิเตอร์

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

รีเทิร์น

Image — Image นี้หลังจากเปลี่ยนทดแทน

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

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

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

replace(imageUrl)

แทนที่รูปภาพนี้ด้วยรูปภาพอื่นที่ดาวน์โหลดจาก URL ที่ระบุ

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image — Image นี้หลังจากเปลี่ยนทดแทน

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

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

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

replace(imageUrl, crop)

แทนที่รูปภาพนี้ด้วยรูปภาพอื่นที่ดาวน์โหลดจาก URL ที่ระบุ โดยอาจมีการครอบตัดรูปภาพให้พอดี

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

URL ที่ระบุต้องมีขนาดไม่เกิน 2 KB

พารามิเตอร์

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

รีเทิร์น

Image — Image นี้หลังจากเปลี่ยนทดแทน

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

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

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

scaleHeight(ratio)

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

scaleWidth(ratio)

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

sendToBack()

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

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้

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

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

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

setHeight(height)

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

setLeft(left)

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

รีเทิร์น

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มุมการหมุนตามเข็มนาฬิกาใหม่ที่จะตั้งค่า หน่วยเป็นองศา

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้

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

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

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

setTop(top)

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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

setTransform(transform)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบนี้สําหรับการต่อเชื่อม

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

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

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

setWidth(width)

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

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

พารามิเตอร์

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

รีเทิร์น

Image — องค์ประกอบหน้าเว็บนี้สําหรับการต่อเชื่อม

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

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

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