चुना गया कॉन्टेंट वह कॉन्टेंट होता है जो किसी खुले प्रज़ेंटेशन पेज में चुना गया हो. जैसे, हाइलाइट किया गया टेक्स्ट या टेबल. इस गाइड में, Apps Script का इस्तेमाल करके किसी चालू प्रज़ेंटेशन में चुने गए टेक्स्ट को पाने और सेट करने का तरीका बताया गया है.
चुना गया डेटा, स्क्रिप्ट शुरू होने के समय का स्नैपशॉट होता है. अगर स्क्रिप्ट चलने के दौरान उपयोगकर्ता क्लिक करता है और चुना गया विकल्प बदल जाता है, तो वे बदलाव नहीं दिखेंगे.
चुनने का तरीका और चुने गए आइटम
Selection क्लास का इस्तेमाल करके, चुने गए हिस्से को पढ़ा जा सकता है. चुने गए ऑब्जेक्ट के टाइप के आधार पर, उन्हें पाने के लिए क्लास में कई तरीके होते हैं.
SelectionType एनम, चुने गए ऑब्जेक्ट के खास टाइप को दिखाता है. उदाहरण के लिए, अगर उपयोगकर्ता ने किसी आकार में कुछ टेक्स्ट चुना है, तो चुने गए टेक्स्ट का टाइप TEXT होगा. इस मामले में, selection.getTextRange()
तरीके का इस्तेमाल करके, चुने गए टेक्स्ट की रेंज को वापस पाया जा सकता है.
आपके पास चुने गए ऑब्जेक्ट को भी वापस पाने का विकल्प है. ऊपर दिए गए उदाहरण के आधार पर, selection.getPageElementRange().getPageElements()[0]
का इस्तेमाल करके, चुने गए टेक्स्ट वाले आकार को वापस पाया जा सकता है. इसी तरह, जिस पेज पर घेरे हुए आकार है वह मौजूदा ऐक्टिव पेज है. उस पेज को वापस पाने के लिए, selection.getCurrentPage()
का इस्तेमाल करें.
चुने गए टेक्स्ट को पढ़ना
चुने गए टेक्स्ट को पढ़ने के लिए, Presentation.getSelection() मैथड का इस्तेमाल करें, जैसा कि इस उदाहरण में दिखाया गया है:
मौजूदा पेज को पढ़ना
उपयोगकर्ता जिस मौजूदा पेज को देख रहा है उसे वापस पाने के लिए, getSelection() और getCurrentPage() तरीकों का इस्तेमाल इस तरह करें:
ध्यान दें कि मौजूदा पेज इनमें से किसी भी तरह का हो सकता है:
मौजूदा पेज पर एक या उससे ज़्यादा ऑब्जेक्ट चुने जा सकते हैं. साथ ही, SelectionType से चुने गए ऑब्जेक्ट का टाइप तय होता है.
चुने गए विकल्प के टाइप के आधार पर, चुना गया टेक्स्ट पढ़ना
यहां दिए गए उदाहरण में बताया गया है कि चुने गए आइटम को सही तरीके से पढ़ने के लिए, चुने गए आइटम के टाइप के हिसाब से, चुने गए आइटम के टाइप का इस्तेमाल कैसे किया जा सकता है.
चुने गए टेक्स्ट को पढ़ना
चुने गए टेक्स्ट को पढ़ने के लिए, Selection.getTextRange() तरीके का इस्तेमाल किया जा सकता है. टेक्स्ट चुनने के दो तरीके हैं:
- रेंज चुनना: अगर किसी आकार में "नमस्ते" टेक्स्ट है और "नमस्ते" चुना गया है, तो दिखाई गई रेंज में startIndex=0 और endIndex=2 होगा.
- कर्सर से चुना गया टेक्स्ट: अगर किसी आकार में "नमस्ते" टेक्स्ट है और कर्सर "ह" ("ह|नमस्ते") के बाद है, तो दिखाई गई रेंज खाली होगी. इसमें startIndex=1 और endIndex=1 होगा.
चुने गए हिस्से में बदलाव करना
स्क्रिप्ट, उपयोगकर्ता के चुने गए विकल्प में बदलाव कर सकती है. स्क्रिप्ट की मदद से प्रज़ेंटेशन में चुने गए आइटम में किए गए बदलाव, स्क्रिप्ट के चलने के दौरान चुने गए आइटम में दिखते हैं.
चुने गए विकल्प में हुए बदलाव, उपयोगकर्ता के ब्राउज़र पर सिर्फ़ तब दिखते हैं, जब स्क्रिप्ट का रन होना पूरा हो जाता है या Presentation.saveAndClose()
को कॉल किया जाता है.
मौजूदा पेज चुनना
selectAsCurrentPage() तरीके को कॉल करके, चालू प्रज़ेंटेशन में किसी पेज को मौजूदा पेज के तौर पर चुना जा सकता है. इस तरीके से, पेज का कोई भी पिछला एलिमेंट, पेज या चुना गया टेक्स्ट हट जाता है. इसलिए, मौजूदा पेज पर इस तरीके का इस्तेमाल करके, पेज पर चुने गए किसी भी विकल्प से चुने हुए का निशान हटाया जा सकता है. उदाहरण के लिए:
पेज एलिमेंट चुनना
किसी पेज में मौजूद पेज एलिमेंट को चुनने के लिए, PageElement.select() तरीके का इस्तेमाल करें. इससे, पहले से चुने गए पेज एलिमेंट भी अनचुने हो जाते हैं.
उदाहरण के लिए:
एक से ज़्यादा पेज एलिमेंट चुनना
चुने गए पेज एलिमेंट में और एलिमेंट जोड़ने के लिए, PageElement.select(false) तरीके का इस्तेमाल करें. सभी पेज एलिमेंट, मौजूदा पेज में होने चाहिए.
चुने गए हिस्से को बदलना
आपकी स्क्रिप्ट में किए गए बदलाव, मौजूदा विकल्प को बदल सकते हैं. इससे, बदलाव के नतीजे के तौर पर चुने गए विकल्प बदल जाते हैं. उदाहरण के लिए:
- मान लें कि आपने दो आकार A और B चुने हैं.
- इसके बाद, आपकी स्क्रिप्ट आकार A को हटा देती है.
- इस वजह से, चुने गए आइटम में बदलाव किया जाता है, ताकि सिर्फ़ आकार B चुना जा सके.
नीचे दिए गए उदाहरण में दिखाया गया है कि चुने गए पेज एलिमेंट में बदलाव करके, चुने गए एलिमेंट को कैसे बदला जा सकता है.
टेक्स्ट चुनना
किसी आकार या टेबल सेल में मौजूद टेक्स्ट को चुनने के लिए, TextRange.select() तरीके का इस्तेमाल किया जा सकता है. अगर टेक्स्ट किसी आकार में है, तो वह आकार भी चुना जाता है. अगर टेक्स्ट किसी टेबल सेल में है, तो उस टेबल सेल और उससे जुड़ी टेबल, दोनों को चुना जाता है.
इससे पैरंट पेज को भी मौजूदा पेज के तौर पर सेट किया जाता है.
किसी आकार में रेंज चुनना
नीचे दिए गए उदाहरण में, किसी आकार में मौजूद टेक्स्ट में रेंज चुनने का तरीका बताया गया है.
किसी आकार में कर्सर से चुना गया हिस्सा
नीचे दिए गए उदाहरण में, किसी आकार में मौजूद टेक्स्ट में कर्सर से टेक्स्ट चुनने का तरीका बताया गया है.
टेबल सेल में रेंज चुनना
यहां दिए गए उदाहरण में, टेबल सेल में मौजूद टेक्स्ट में से रेंज चुनने का तरीका बताया गया है.
TableCell में कर्सर से चुनना
नीचे दिए गए उदाहरण में, टेबल सेल में मौजूद टेक्स्ट में कर्सर चुनने का तरीका बताया गया है.
टेक्स्ट में बदलाव करके, चुने गए हिस्से में बदलाव करना
नीचे दिए गए उदाहरण में बताया गया है कि चुने गए टेक्स्ट में बदलाव करके, चुने गए हिस्से को कैसे बदला जा सकता है.
चुने हुए का निशान हटाना
टेक्स्ट या पेज एलिमेंट से चुने हुए का निशान हटाने के लिए, कोई खास तरीका नहीं है. हालांकि, Page.selectAsCurrentPage()
या pageElement.select()
तरीकों का इस्तेमाल करके भी यह नतीजा मिल सकता है.
कोई मौजूदा पेज चुनना
नीचे दिए गए उदाहरण में, किसी पेज को मौजूदा पेज के तौर पर सेट करके, उस पर चुने गए किसी भी विकल्प को अनचुना करने का तरीका बताया गया है.
कोई पेज एलिमेंट चुनना
नीचे दिए गए उदाहरण में, किसी पेज के किसी एलिमेंट को चुनकर, पेज पर चुने गए किसी भी मौजूदा विकल्प को हटाने का तरीका बताया गया है. इससे, चुने गए अन्य सभी आइटम हट जाते हैं.