PageElement
แสดงแผนภูมิที่ลิงก์ไว้ซึ่งฝังจาก Google ชีต
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
alignOnPage(alignmentPosition) | SheetsChart | จัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ |
asImage() | Image | แสดงแผนภูมิเป็นรูปภาพหรือ null หากแผนภูมิไม่ใช่รูปภาพที่ฝัง |
bringForward() | SheetsChart | นำองค์ประกอบของหน้าไปข้างหน้าทีละองค์ประกอบ |
bringToFront() | SheetsChart | นำองค์ประกอบของหน้าไปไว้ด้านหน้าสุด |
duplicate() | PageElement | ทําซ้ำองค์ประกอบของหน้า |
getChartId() | Integer | รับรหัสของแผนภูมิที่ต้องการในสเปรดชีตของ Google ชีตที่ฝัง |
getConnectionSites() | ConnectionSite[] | แสดงรายการ ConnectionSite ในองค์ประกอบหน้า หรือรายการว่างเปล่าหากองค์ประกอบหน้าไม่มีเว็บไซต์การเชื่อมต่อ |
getDescription() | String | แสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า |
getEmbedType() | SheetsChartEmbedType | แสดงผลประเภทการฝังของแผนภูมิชีต |
getHeight() | Number | รับความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องล้อมรอบองค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
getInherentHeight() | Number | แสดงผลความสูงโดยธรรมชาติขององค์ประกอบเป็นจุด |
getInherentWidth() | Number | แสดงผลความกว้างตามธรรมชาติขององค์ประกอบเป็นจุด |
getLeft() | Number | แสดงผลตำแหน่งแนวนอนขององค์ประกอบเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
getLink() | Link | แสดงผล Link หรือ null หากไม่มีลิงก์ |
getObjectId() | String | แสดงรหัสที่ไม่ซ้ำกันสำหรับออบเจ็กต์นี้ |
getPageElementType() | PageElementType | แสดงผลประเภทองค์ประกอบของหน้า ซึ่งแสดงเป็น enum PageElementType |
getParentGroup() | Group | แสดงผลกลุ่มที่ประกอบด้วยองค์ประกอบหน้านี้ หรือ null หากองค์ประกอบไม่ได้อยู่ในกลุ่ม |
getParentPage() | Page | แสดงหน้าที่แสดงองค์ประกอบของหน้านี้ |
getRotation() | Number | แสดงผลมุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา โดย 0 องศาหมายถึงไม่มีการหมุน |
getSpreadsheetId() | String | รับรหัสของสเปรดชีต Google ชีตที่มีแผนภูมิต้นฉบับ |
getTitle() | String | แสดงชื่อข้อความแสดงแทนขององค์ประกอบหน้า |
getTop() | Number | ได้รับตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้า เมื่อองค์ประกอบไม่มีการหมุน |
getTransform() | AffineTransform | แสดงการเปลี่ยนรูปแบบขององค์ประกอบหน้า |
getWidth() | Number | แสดงผลความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
preconcatenateTransform(transform) | SheetsChart | เชื่อมโยงการแปลงที่ระบุล่วงหน้ากับการแปลงที่มีอยู่ขององค์ประกอบหน้าเว็บ |
refresh() | void | รีเฟรชแผนภูมิโดยแทนที่ด้วยแผนภูมิเวอร์ชันล่าสุดจาก Google ชีต |
remove() | void | นำองค์ประกอบของหน้าออก |
removeLink() | void | นำ Link ออก |
scaleHeight(ratio) | SheetsChart | ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ |
scaleWidth(ratio) | SheetsChart | ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ |
select() | void | เลือกเฉพาะ PageElement ในงานนำเสนอที่ใช้งานอยู่และนำการเลือกก่อนหน้านี้ออก |
select(replace) | void | เลือก PageElement ในงานนำเสนอที่ใช้งานอยู่ |
sendBackward() | SheetsChart | ส่งองค์ประกอบหน้าไปข้างหลังในหน้าโดย 1 องค์ประกอบ |
sendToBack() | SheetsChart | ส่งองค์ประกอบของหน้าไปด้านหลังของหน้า |
setDescription(description) | SheetsChart | ตั้งค่าคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า |
setHeight(height) | SheetsChart | กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องล้อมรอบองค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
setLeft(left) | SheetsChart | กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
setLinkSlide(slideIndex) | Link | ตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ดัชนีฐาน 0 ของสไลด์ |
setLinkSlide(slide) | Link | ตั้งค่า Link เป็น Slide ที่กำหนด ลิงก์จะตั้งค่าตามรหัสสไลด์ที่กำหนด |
setLinkSlide(slidePosition) | Link | ตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ตำแหน่งสัมพัทธ์ของสไลด์ |
setLinkUrl(url) | Link | ตั้งค่า Link ให้กับสตริง URL ที่ไม่ว่างเปล่า |
setRotation(angle) | SheetsChart | ตั้งค่ามุมหมุนตามเข็มนาฬิกาขององค์ประกอบจากจุดศูนย์กลาง หน่วยเป็นองศา |
setTitle(title) | SheetsChart | ตั้งชื่อข้อความแสดงแทนขององค์ประกอบหน้า |
setTop(top) | SheetsChart | กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน |
setTransform(transform) | SheetsChart | ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วยการเปลี่ยนรูปแบบที่ระบุ |
setWidth(width) | SheetsChart | กำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน |
เอกสารโดยละเอียด
alignOnPage(alignmentPosition)
จัดองค์ประกอบให้อยู่ในตำแหน่งเดียวกับที่ระบุในหน้าเว็บ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignmentPosition | AlignmentPosition | ตำแหน่งที่จะจัดองค์ประกอบของหน้านี้ให้ในหน้า |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
asImage()
แสดงแผนภูมิเป็นรูปภาพหรือ null
หากแผนภูมิไม่ใช่รูปภาพที่ฝัง
รีเทิร์น
Image
— แผนภูมินี้เป็นรูปภาพ หรือ null
หากแผนภูมิไม่ใช่รูปภาพที่ฝัง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringForward()
นำองค์ประกอบของหน้าไปข้างหน้าทีละองค์ประกอบ
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
นำองค์ประกอบของหน้าไปไว้ด้านหน้าสุด
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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
getChartId()
รับรหัสของแผนภูมิที่ต้องการในสเปรดชีตของ Google ชีตที่ฝัง
รีเทิร์น
Integer
— รหัสของแผนภูมิที่ฝัง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
แสดงรายการ ConnectionSite
ในองค์ประกอบหน้า หรือรายการว่างเปล่าหากองค์ประกอบหน้าไม่มีเว็บไซต์การเชื่อมต่อ
รีเทิร์น
ConnectionSite[]
— รายการเว็บไซต์การเชื่อมต่อ ซึ่งอาจว่างเปล่าหากองค์ประกอบนี้ไม่มีเว็บไซต์การเชื่อมต่อ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
แสดงคำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า คำอธิบายจะรวมเข้ากับชื่อเพื่อแสดง และอ่านข้อความแสดงแทน
รีเทิร์น
String
— คำอธิบายข้อความแสดงแทนขององค์ประกอบหน้า
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEmbedType()
แสดงผลประเภทการฝังของแผนภูมิชีต
รีเทิร์น
SheetsChartEmbedType
— ประเภทการฝังของแผนภูมินี้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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
getLink()
แสดงผล Link
หรือ null
หากไม่มีลิงก์
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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()
getRotation()
แสดงผลมุมการหมุนตามเข็มนาฬิกาขององค์ประกอบรอบจุดศูนย์กลางเป็นองศา โดย 0 องศาหมายถึงไม่มีการหมุน
รีเทิร์น
Number
— มุมการหมุน หน่วยเป็นองศาระหว่าง 0 (รวม) และ 360 (ไม่รวม)
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSpreadsheetId()
รับรหัสของสเปรดชีต Google ชีตที่มีแผนภูมิต้นฉบับ
รีเทิร์น
String
— รหัสของสเปรดชีตที่มีแผนภูมิแหล่งที่มา
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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)
ได้ด้วย
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
transform | AffineTransform | การเปลี่ยนรูปแบบเพื่อเชื่อมไปยังการเปลี่ยนรูปแบบขององค์ประกอบในหน้านี้ล่วงหน้า |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
refresh()
รีเฟรชแผนภูมิโดยแทนที่ด้วยแผนภูมิเวอร์ชันล่าสุดจาก Google ชีต หากแผนภูมิเป็นปัจจุบันแล้ว ไม่ต้องทำการเปลี่ยนแปลงใดๆ กับแผนภูมิในงานนำเสนอ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.readonly
remove()
นำองค์ประกอบของหน้าออก
หากหลังจากการดำเนินการนำออก Group
มีองค์ประกอบของหน้าเว็บเพียง 1 รายการหรือไม่มีเลย ระบบก็จะนำกลุ่มนั้นออกด้วย
หากนำตัวยึดตำแหน่ง PageElement
ออกจากต้นแบบหรือเลย์เอาต์ ระบบจะนำตัวยึดตำแหน่งที่รับค่ามาที่ว่างเปล่าออกด้วย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
นำ Link
ออก
shape.removeLink();
scaleHeight(ratio)
ปรับขนาดความสูงขององค์ประกอบตามอัตราส่วนที่ระบุ ความสูงขององค์ประกอบคือความสูงของช่องล้อมรอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
ratio | Number | อัตราส่วนที่ใช้ปรับขนาดความสูงขององค์ประกอบหน้านี้ |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
ปรับขนาดความกว้างขององค์ประกอบตามอัตราส่วนที่ระบุ ความกว้างขององค์ประกอบคือความกว้างของกล่องขอบเขตเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
ratio | Number | อัตราส่วนที่ใช้ปรับขนาดความกว้างขององค์ประกอบหน้านี้ |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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
Page
ระดับบนของออบเจ็กต์PageElement
ต้องเป็นcurrent page selection
- ไม่ควรเลือกออบเจ็กต์
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); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
replace | Boolean | หากเป็น true การเลือกดังกล่าวจะแทนที่การเลือกก่อนหน้า มิฉะนั้นระบบจะเพิ่มการเลือกนี้ลงในการเลือกก่อนหน้า |
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
ส่งองค์ประกอบหน้าไปข้างหลังในหน้าโดย 1 องค์ประกอบ
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
ส่งองค์ประกอบของหน้าไปด้านหลังของหน้า
องค์ประกอบของหน้าต้องไม่อยู่ในกลุ่ม
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
description | String | สตริงที่จะตั้งคำอธิบายข้อความแสดงแทน |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
กำหนดความสูงขององค์ประกอบเป็นจุด ซึ่งเป็นความสูงของช่องล้อมรอบองค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
height | Number | ความสูงใหม่ขององค์ประกอบหน้าเว็บนี้ที่จะกำหนดเป็นจุด |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
กำหนดตำแหน่งแนวนอนขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
left | Number | ตำแหน่งแนวนอนใหม่ในหน่วยจุด |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
slideIndex | Integer | ดัชนีฐาน 0 ของสไลด์ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
slide | Slide | Slide ที่จะลิงก์ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
slidePosition | SlidePosition | SlidePosition เชิงสัมพัทธ์ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
url | String | สตริง URL |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
ตั้งค่ามุมหมุนตามเข็มนาฬิกาขององค์ประกอบจากจุดศูนย์กลาง หน่วยเป็นองศา
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
angle | Number | มุมการหมุนตามเข็มนาฬิกาใหม่ที่จะตั้งค่า หน่วยเป็นองศา |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | สตริงที่จะใช้ตั้งชื่อข้อความแสดงแทน |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
กำหนดตำแหน่งแนวตั้งขององค์ประกอบเป็นจุด โดยวัดจากมุมซ้ายบนของหน้าเมื่อองค์ประกอบไม่มีการหมุน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Number | ตำแหน่งแนวตั้งใหม่ที่จะตั้งค่า หน่วยเป็นจุด |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
ตั้งค่าการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บด้วยการเปลี่ยนรูปแบบที่ระบุ
การอัปเดตการเปลี่ยนรูปแบบของกลุ่มจะเปลี่ยนการเปลี่ยนแปลงแบบสัมบูรณ์ขององค์ประกอบหน้าในกลุ่มนั้น ซึ่งอาจเปลี่ยนรูปลักษณ์ได้
การอัปเดตการเปลี่ยนรูปแบบขององค์ประกอบหน้าเว็บที่อยู่ในกลุ่มจะเปลี่ยนการเปลี่ยนรูปแบบขององค์ประกอบหน้านั้นเท่านั้น โดยจะไม่ส่งผลต่อการแปลงของกลุ่มหรือองค์ประกอบของหน้าอื่นๆ ในกลุ่มดังกล่าว
ดูรายละเอียดเกี่ยวกับผลของการเปลี่ยนรูปแบบต่อรูปลักษณ์ขององค์ประกอบหน้าได้ที่ getTransform()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
transform | AffineTransform | การเปลี่ยนรูปแบบที่ตั้งไว้สําหรับองค์ประกอบของหน้านี้ |
รีเทิร์น
SheetsChart
— องค์ประกอบนี้สำหรับการทำห่วงโซ่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
กำหนดความกว้างขององค์ประกอบเป็นจุด ซึ่งเป็นความกว้างของช่องขอบเขตขององค์ประกอบเมื่อองค์ประกอบไม่มีการหมุน
วิธีนี้ไม่สามารถทำงานร่วมกับองค์ประกอบทั้งหมดของหน้าเว็บได้ หากต้องการเรียนรู้ว่าองค์ประกอบใดของหน้าเว็บที่ใช้ไม่ได้กับวิธีนี้ โปรดดู ข้อจำกัดด้านขนาดและการวางตำแหน่ง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
width | Number | ความกว้างใหม่ขององค์ประกอบของหน้านี้ที่จะตั้งค่า หน่วยเป็นจุด |
รีเทิร์น
SheetsChart
— องค์ประกอบของหน้านี้สำหรับการเชื่อมโยง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations