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

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