Class Range

रेंज

दस्तावेज़ में मौजूद एलिमेंट की एक रेंज. उपयोगकर्ता के चुने गए विकल्प को 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

ऐसे तरीके जो अब काम नहीं करते