चुना गया कॉन्टेंट, खुले हुए प्रज़ेंटेशन पेज में फ़िलहाल चुना गया कोई भी कॉन्टेंट होता है. जैसे, हाइलाइट किया गया टेक्स्ट या कोई टेबल. इस गाइड में, Apps Script का इस्तेमाल करके, चालू प्रज़ेंटेशन में सिलेक्शन पाने और उसे सेट करने का तरीका बताया गया है.
चुना गया हिस्सा, स्क्रिप्ट शुरू होने के समय का स्नैपशॉट होता है. अगर स्क्रिप्ट चालू होने के दौरान उपयोगकर्ता क्लिक करता है और चुने गए सेल में बदलाव होता है, तो वे बदलाव नहीं दिखेंगे.
चुनी गई वैल्यू और चुनने का तरीका
Selection क्लास का इस्तेमाल करके, चुने गए टेक्स्ट को पढ़ा जा सकता है. क्लास में, चुने गए ऑब्जेक्ट के टाइप के आधार पर, चुने गए ऑब्जेक्ट पाने के कई तरीके होते हैं.
SelectionType enum, चुने गए ऑब्जेक्ट के टाइप को दिखाता है. उदाहरण के लिए, अगर उपयोगकर्ता ने किसी शेप में कुछ टेक्स्ट चुना है, तो चुनने का टाइप TEXT होगा. इस मामले में, selection.getTextRange()
तरीके का इस्तेमाल करके, चुने गए टेक्स्ट की रेंज को वापस पाया जा सकता है.
चुने गए ऑब्जेक्ट को भी वापस लाया जा सकता है. ऊपर दिए गए उदाहरण में, चुने गए टेक्स्ट वाले शेप को वापस लाने के लिए selection.getPageElementRange().getPageElements()[0]
का इस्तेमाल किया जा सकता है. इसी तरह, जिस पेज में शामिल करने वाला शेप मौजूद है वह मौजूदा चालू पेज है. उस पेज को वापस पाने के लिए, selection.getCurrentPage()
का इस्तेमाल करें.
चुने गए टेक्स्ट को पढ़ना
चुने गए टेक्स्ट को पढ़ने के लिए, Presentation.getSelection() तरीके का इस्तेमाल करें. इसका उदाहरण यहां दिया गया है:
मौजूदा पेज को पढ़कर सुनाना
उपयोगकर्ता जिस मौजूदा Page को देख रहा है उसे वापस पाने के लिए, getSelection() और getCurrentPage() तरीकों का इस्तेमाल इस तरह करें:
ध्यान दें कि मौजूदा पेज इनमें से किसी भी तरह का हो सकता है:
मौजूदा पेज पर एक या उससे ज़्यादा ऑब्जेक्ट चुने जा सकते हैं. SelectionType से यह तय होता है कि किस तरह का ऑब्जेक्ट चुना गया है.
चुने गए टेक्स्ट को, चुने गए टाइप के हिसाब से पढ़ना
यहां दिए गए उदाहरण में बताया गया है कि टाइप के हिसाब से सही तरीके से मौजूदा सिलेक्शन को पढ़ने के लिए, सिलेक्शन टाइप का इस्तेमाल कैसे किया जा सकता है.
चुने गए टेक्स्ट को पढ़ना
Selection.getTextRange() तरीके का इस्तेमाल करके, चुने गए टेक्स्ट को पढ़ा जा सकता है. टेक्स्ट चुनने के दो तरीके होते हैं:
- रेंज चुनना: अगर किसी शेप में "Hello" टेक्स्ट है और "He" चुना गया है, तो दिखाई गई रेंज में startIndex=0 और endIndex=2 होगा.
- कर्सर से चुना गया टेक्स्ट: अगर किसी शेप में "Hello" टेक्स्ट है और कर्सर "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()
तरीकों का इस्तेमाल करके यह नतीजा पाया जा सकता है.
मौजूदा पेज चुनें
नीचे दिए गए उदाहरण में, किसी पेज को मौजूदा पेज के तौर पर सेट करके, उस पेज पर चुने गए मौजूदा आइटम को हटाने का तरीका बताया गया है.
कोई पेज एलिमेंट चुनना
यहां दिए गए उदाहरण में, किसी पेज पर मौजूद मौजूदा सिलेक्शन को हटाने का तरीका बताया गया है. इसके लिए, पेज के किसी एक एलिमेंट को चुना जाता है. इससे, चुने गए सभी आइटम हट जाते हैं.