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 एलिमेंट का कुछ हिस्सा शामिल है.
तरीकारिटर्न टाइपसंक्षिप्त विवरण
getSelectedElements()RangeElement[]दस्तावेज़ के खुले हुए इंस्टेंस में, उपयोगकर्ता के चुने गए सभी एलिमेंट दिखाता है. इनमें, कुछ हद तक चुने गए Text एलिमेंट भी शामिल हैं.

ज़्यादा जानकारी वाला दस्तावेज़

getRangeElements()

इस Range में मौजूद सभी एलिमेंट पाता है. इनमें कुछ हिस्से वाले Text एलिमेंट भी शामिल हैं. उदाहरण के लिए, ऐसे सिलेक्शन के मामले में जिसमें सिर्फ़ Text एलिमेंट का कुछ हिस्सा शामिल है. यह पता लगाने के लिए कि कोई Text एलिमेंट, रेंज में सिर्फ़ कुछ हिस्से में शामिल है या नहीं, RangeElement.isPartial() देखें.

वापसी का टिकट

RangeElement[] — दस्तावेज़ में दिखने के क्रम में एलिमेंट का कलेक्शन

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

अब काम न करने वाले तरीके

अब काम नहीं करता. नाम बदलकर getRangeElements() किया गया.

दस्तावेज़ के खुले हुए इंस्टेंस में, उपयोगकर्ता के चुने गए सभी एलिमेंट दिखाता है. इनमें, कुछ हद तक चुने गए Text एलिमेंट भी शामिल हैं.

वापसी का टिकट

RangeElement[] — चुने गए या कुछ हिस्से के तौर पर चुने गए एलिमेंट का ऐरे, जिस क्रम में वे दस्तावेज़ में दिखते हैं

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents