טווח של רכיבים במסמך. בחירת המשתמש מיוצגת כ-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