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);
      }
    }
  }
}

روش ها

روش نوع برگشت شرح مختصر
get Range Elements() Range Element[] همه عناصر را در این Range دریافت می کند، از جمله هر عنصر Text جزئی (مثلاً در مورد انتخابی که فقط بخشی از یک عنصر Text را شامل می شود).

مستندات دقیق

get Range Elements()

همه عناصر را در این Range دریافت می کند، از جمله هر عنصر Text جزئی (مثلاً در مورد انتخابی که فقط بخشی از یک عنصر Text را شامل می شود). برای تعیین اینکه آیا یک عنصر Text فقط تا حدی در محدوده گنجانده شده است، Range Element.isPartial() ببینید.

بازگشت

Range Element[] - مجموعه ای از عناصر ، به ترتیب آنها در سند ظاهر می شوند

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

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