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

الطرق التي تم إيقافها نهائيًا