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

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