การเลือกคือสิ่งที่เลือกอยู่ในหน้างานนำเสนอที่เปิดอยู่ เช่น ข้อความที่ไฮไลต์หรือตาราง คู่มือนี้จะบอกวิธีรับ และตั้งค่าการเลือกในงานนำเสนอที่ใช้งานอยู่โดยใช้ Apps Script
การเลือกคือสแนปชอตของสิ่งที่เกิดขึ้นเมื่อสคริปต์เริ่มทำงาน หากผู้ใช้คลิกและมีการเปลี่ยนแปลงการเลือกขณะที่สคริปต์ทำงาน การเปลี่ยนแปลงเหล่านั้นจะไม่แสดง
การเลือกและประเภทการเลือก
คุณอ่านข้อความที่เลือกได้โดยใช้คลาส Selection คลาสมีหลายวิธีในการรับออบเจ็กต์ที่เลือกตาม ประเภทของออบเจ็กต์ที่เลือก
การแจงนับ SelectionType
แสดงถึงประเภทที่เฉพาะเจาะจงของออบเจ็กต์ที่เลือก เช่น หากผู้ใช้เลือกข้อความในรูปร่าง ประเภทการเลือกจะเป็น TEXT ในกรณีนี้ คุณสามารถดึงข้อความที่เลือกได้โดยใช้เมธอด
selection.getTextRange()
นอกจากนี้ คุณยังดึงข้อมูลออบเจ็กต์ที่มีข้อความที่เลือกได้ด้วย โดยหากใช้ตัวอย่างข้างต้น คุณจะดึงข้อมูลรูปร่างที่มีข้อความที่เลือกได้โดยใช้ selection.getPageElementRange().getPageElements()[0]
ในทำนองเดียวกัน หน้าที่มีรูปร่างล้อมรอบคือหน้าปัจจุบันที่ใช้งานอยู่ หากต้องการดึงข้อมูลหน้าดังกล่าว ให้ใช้ selection.getCurrentPage()
การอ่านข้อความที่เลือก
หากต้องการอ่านข้อความที่เลือก ให้ใช้เมธอด Presentation.getSelection() ดังที่แสดงในตัวอย่างต่อไปนี้
การอ่านหน้าปัจจุบัน
หากต้องการดึงข้อมูลหน้าปัจจุบันที่ผู้ใช้กำลังดู ให้ใช้วิธี getSelection() และ getCurrentPage() ดังนี้
โปรดทราบว่าหน้าปัจจุบันอาจเป็นประเภทใดประเภทหนึ่งต่อไปนี้
หน้าปัจจุบันสามารถเลือกออบเจ็กต์ได้ตั้งแต่ 1 รายการขึ้นไป และ SelectionType จะกำหนดประเภทของการเลือก
การอ่านข้อความที่เลือกตามประเภทการเลือก
ตัวอย่างต่อไปนี้แสดงวิธีใช้ประเภทการเลือกเพื่ออ่านข้อความที่เลือกในปัจจุบันด้วยวิธีที่เหมาะสมกับประเภท
การอ่านข้อความที่เลือก
คุณอ่านข้อความที่เลือกได้โดยใช้เมธอด Selection.getTextRange() การเลือกข้อความมี 2 ประเภท ได้แก่
- การเลือกช่วง: หากรูปร่างมีข้อความ "Hello" และมีการเลือก "He" ช่วงที่แสดงผลจะมี startIndex=0 และ endIndex=2
- การเลือกเคอร์เซอร์: หากรูปร่างมีข้อความ "Hello" และเคอร์เซอร์อยู่ หลัง "H" ("H|ello") ช่วงที่แสดงผลจะเป็นช่วงว่างที่มี startIndex=1 และ endIndex=1
การแก้ไขการเลือก
สคริปต์สามารถแก้ไขตัวเลือกของผู้ใช้ได้ การเปลี่ยนแปลงการเลือกใดๆ ที่สคริปต์ทำกับงานนำเสนอจะแสดง ในการดำเนินการเลือกที่ตามมาในช่วงระยะเวลาการดำเนินการของสคริปต์
การเปลี่ยนแปลงการเลือกจะแสดงในเบราว์เซอร์ของผู้ใช้หลังจากที่สคริปต์
ทํางานเสร็จสมบูรณ์ หรือเมื่อมีการเรียกใช้ Presentation.saveAndClose()
เท่านั้น
การเลือกหน้าปัจจุบัน
คุณเลือกหน้าในงานนำเสนอที่ใช้งานอยู่เป็นหน้าปัจจุบันได้โดยเรียกใช้เมธอด selectAsCurrentPage() วิธีนี้จะนำองค์ประกอบหน้าเว็บ หน้าเว็บ หรือข้อความที่เลือกก่อนหน้าออก ดังนั้นการใช้วิธีนี้ในหน้าปัจจุบันจะช่วยให้คุณยกเลิกการเลือกปัจจุบันในหน้าได้ เช่น
การเลือกองค์ประกอบของหน้า
หากต้องการเลือกองค์ประกอบหน้าเว็บในหน้า ให้ใช้วิธี PageElement.select() การดำเนินการนี้จะยกเลิกการเลือกองค์ประกอบหน้าเว็บที่เลือกไว้ก่อนหน้านี้ด้วย
เช่น
การเลือกองค์ประกอบหลายหน้า
หากต้องการเพิ่มองค์ประกอบหน้าเว็บอื่นๆ ลงในการเลือก ให้ใช้วิธี PageElement.select(false) องค์ประกอบหน้าเว็บทั้งหมดต้องอยู่ในหน้าปัจจุบัน
การเปลี่ยนรูปส่วนที่เลือก
การแก้ไขที่สคริปต์ดำเนินการจะเปลี่ยนรูปแบบส่วนที่เลือกในปัจจุบัน เพื่อให้ สิ่งที่เลือกเปลี่ยนแปลงตามผลลัพธ์ของการแก้ไข เช่น
- สมมติว่าคุณเลือกรูปร่าง 2 รูปคือ A และ B
- จากนั้นสคริปต์จะนำรูปร่าง ก. ออก
- ด้วยเหตุนี้ ระบบจึงแปลงการเลือกเทียบกับการแก้ไขเพื่อให้เลือกได้เฉพาะ รูปร่าง B
ตัวอย่างต่อไปนี้แสดงวิธีเปลี่ยนรูปแบบการเลือกโดยการแก้ไข องค์ประกอบของหน้าที่เลือก
การเลือกข้อความ
คุณเลือกข้อความที่อยู่ในรูปร่างหรือในเซลล์ตารางได้โดยใช้เมธอด TextRange.select() หากข้อความอยู่ในรูปร่าง ระบบจะเลือกรูปร่างนั้นด้วย หากข้อความอยู่ในเซลล์ตาราง ระบบจะเลือกทั้งเซลล์ตารางและตารางที่ครอบคลุม
ซึ่งจะตั้งค่าหน้าหลักเป็นหน้าปัจจุบันด้วย
การเลือกช่วงในรูปร่าง
ตัวอย่างต่อไปนี้แสดงวิธีเลือกช่วงภายในข้อความที่อยู่ในรูปร่าง
การเลือกเคอร์เซอร์ในรูปร่าง
ตัวอย่างต่อไปนี้แสดงวิธีเลือกเคอร์เซอร์ภายในข้อความที่อยู่ในรูปร่าง
การเลือกช่วงในเซลล์ของตาราง
ตัวอย่างต่อไปนี้แสดงวิธีเลือกช่วงภายในข้อความที่อยู่ในเซลล์ตาราง
การเลือกเคอร์เซอร์ใน TableCell
ตัวอย่างต่อไปนี้แสดงวิธีเลือกเคอร์เซอร์ภายในข้อความที่มีอยู่ในเซลล์ตาราง
การเปลี่ยนรูปแบบการเลือกด้วยการแก้ไขข้อความ
ตัวอย่างต่อไปนี้แสดงวิธีเปลี่ยนรูปแบบข้อความที่เลือกโดยการแก้ไข ข้อความที่เลือก
ยกเลิกการเลือก
ไม่มีวิธีที่ชัดเจนในการยกเลิกการเลือกข้อความหรือองค์ประกอบของหน้า อย่างไรก็ตาม คุณสามารถทำได้โดยใช้วิธี Page.selectAsCurrentPage()
หรือ pageElement.select()
เลือกหน้าปัจจุบัน
ตัวอย่างต่อไปนี้แสดงวิธียกเลิกการเลือกปัจจุบันในหน้าเว็บโดยการตั้งค่าหน้าเว็บนั้นเป็นหน้าปัจจุบัน
เลือกองค์ประกอบหน้าเว็บ
ตัวอย่างต่อไปนี้แสดงวิธียกเลิกการเลือกปัจจุบันในหน้า โดยการเลือกองค์ประกอบของหน้า 1 รายการ ซึ่งจะนำรายการอื่นๆ ทั้งหมดออกจากส่วนที่เลือก