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).

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
getSelectedElements()	RangeElement[]	הפונקציה מקבלת את כל הרכיבים שהמשתמש בחר במופע הפתוח של המסמך, כולל רכיבי Text שנבחרו באופן חלקי.

תיעוד מפורט

getRangeElements()

הפונקציה מקבלת את כל הרכיבים ב-Range, כולל רכיבי Text חלקיים (לדוגמה, במקרה של בחירה שכוללת רק חלק מרכיב Text). כדי לקבוע אם רכיב Text נכלל רק באופן חלקי בטווח, אפשר לעיין ב-RangeElement.isPartial().

החזרות

RangeElement[] - מערך של רכיבים, לפי הסדר שבו הם מופיעים במסמך

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

שיטות שהוצאו משימוש

getSelectedElements()

הוצא משימוש. השם החדש הוא getRangeElements().

הפונקציה מקבלת את כל הרכיבים שהמשתמש בחר במופע הפתוח של המסמך, כולל רכיבי Text שנבחרו באופן חלקי.

החזרות

RangeElement[] - מערך של רכיבים שנבחרו או שנבחרו באופן חלקי, לפי הסדר שבו הם מופיעים במסמך

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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