טווח של רכיבים במסמך. הבחירה של המשתמש מיוצגת כ-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); } } } }
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | Range | מחזירה את כל הרכיבים ב-Range, כולל רכיבי Text חלקיים (לדוגמה, במקרה של בחירה שכוללת רק חלק מרכיב Text). |
תיעוד מפורט
getRangeElements()
מחזירה את כל הרכיבים ב-Range, כולל רכיבי Text חלקיים (לדוגמה, במקרה של בחירה שכוללת רק חלק מרכיב Text). כדי לקבוע אם רכיב Text נכלל רק באופן חלקי בטווח, אפשר לעיין בRangeElement.isPartial().
חזרה
RangeElement[] – מערך של רכיבים, בסדר שבו הם מופיעים במסמך
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents