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

الطرق المتوقّفة نهائيًا