Class Range

النطاق

نطاق من العناصر في مستند يتم تمثيل اختيار المستخدم على شكل Range، من بين الاستخدامات الأخرى. لا يمكن للنصوص البرمجية الوصول إلا إلى المحتوى الذي يحدّده المستخدم الذي يشغّل النص البرمجي، وذلك فقط إذا كان النص البرمجي مرتبطًا بالمستند. 

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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

الطرق المتوقّفة