किसी दस्तावेज़ में एलिमेंट की रेंज. दूसरे इस्तेमाल के बीच, उपयोगकर्ता के चुने गए विकल्प को 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);
}
}
}
}
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
getRangeElements() | RangeElement[] | इस Range के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें. |
ज़्यादा जानकारी के साथ दस्तावेज़
getRangeElements()
इस Range के सभी एलिमेंट की जानकारी देता है. इनमें, कुछ हद तक Text एलिमेंट शामिल हैं. उदाहरण के लिए, अगर किसी विकल्प में Text एलिमेंट का सिर्फ़ एक हिस्सा शामिल है, तो उसे चुनें. यह पता करने के लिए कि कोई Text एलिमेंट, रेंज में सिर्फ़ कुछ हद तक शामिल है या नहीं, RangeElement.isPartial() देखें.
रिटर्न
RangeElement[] — एलिमेंट का कलेक्शन, जिस क्रम में दस्तावेज़ में दिखता है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents