संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
रेंज
किसी दस्तावेज़ में एलिमेंट की रेंज. दूसरे इस्तेमाल के बीच, उपयोगकर्ता के चुने गए विकल्प को Range के तौर पर दिखाया जाता है. स्क्रिप्ट सिर्फ़ उस उपयोगकर्ता के चुने हुए को ऐक्सेस कर सकती हैं जो स्क्रिप्ट चला रहा है. वह सिर्फ़ तब ऐक्सेस कर सकता है, जब स्क्रिप्ट दस्तावेज़ से जुड़ी हो.
// Bold all selected text.
var selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
var elements = selection.getRangeElements();
for (var i = 0; i < elements.length; i++) {
var element = elements[i];
// Only modify elements that can be edited as text; skip images and other non-text elements.
if (element.getElement().editAsText) {
var text = element.getElement().editAsText();
// Bold the selected part of the element, or the full element if it's completely selected.
if (element.isPartial()) {
text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true);
} else {
text.setBold(true);
}
}
}
}
इस Range के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें.
इसमें वे सभी एलिमेंट दिखते हैं जिन्हें उपयोगकर्ता ने दस्तावेज़ के ओपन इंस्टेंस में चुना है. इसमें ऐसे Text एलिमेंट भी शामिल हैं जिन्हें कुछ हद तक चुना गया है.
ज़्यादा जानकारी के साथ दस्तावेज़
getRangeElements()
इस Range के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें. यह पता करने के लिए कि कोई Text एलिमेंट, रेंज में सिर्फ़ कुछ हद तक शामिल है या नहीं, RangeElement.isPartial() देखें.
रिटर्न
RangeElement[] — एलिमेंट का कलेक्शन, जिस क्रम में दस्तावेज़ में दिखता है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
इसमें वे सभी एलिमेंट दिखते हैं जिन्हें उपयोगकर्ता ने दस्तावेज़ के ओपन इंस्टेंस में चुना है. इसमें ऐसे Text एलिमेंट भी शामिल हैं जिन्हें कुछ हद तक चुना गया है.
रिटर्न
RangeElement[] — चुने गए या कुछ हद तक चुने गए एलिमेंट का कलेक्शन, जिस क्रम में वे दस्तावेज़ में दिखते हैं
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है: