Class Range

रेंज

किसी दस्तावेज़ में मौजूद एलिमेंट की रेंज. उपयोगकर्ता के चुने गए विकल्प को Range के तौर पर दिखाया जाता है. इसके अलावा, इसका इस्तेमाल अन्य कामों के लिए भी किया जाता है. स्क्रिप्ट सिर्फ़ उस उपयोगकर्ता के चुने गए डेटा को ऐक्सेस कर सकती है जो स्क्रिप्ट चला रहा है. साथ ही, ऐसा सिर्फ़ तब किया जा सकता है, जब स्क्रिप्ट दस्तावेज़ से बाइंड हो. 

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता