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