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