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

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