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 را شامل می‌شود) را برمی‌گرداند.

مستندات دقیق

getRangeElements()

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

بازگشت

RangeElement[] — آرایه‌ای از عناصر، به ترتیبی که در سند ظاهر می‌شوند

مجوز

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

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

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