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

روش های منسوخ شده