קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
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);
}
}
}
}
הפונקציה מקבלת את כל הרכיבים שהמשתמש בחר במופע הפתוח של המסמך, כולל רכיבי Text שנבחרו באופן חלקי.
מסמכים מפורטים
getRangeElements()
הפונקציה מקבלת את כל הרכיבים ב-Range הזה, כולל רכיבי Text חלקיים (לדוגמה, במקרה של בחירה שכוללת רק חלק מאלמנט Text). כדי לקבוע אם רכיב Text נכלל בטווח באופן חלקי בלבד, אפשר לעיין במאמר RangeElement.isPartial().
חזרה
RangeElement[] – מערך של רכיבים, בסדר שבו הם מופיעים במסמך
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-12-03 (שעון UTC)."],[[["A `Range` represents a range of elements in a Google Doc, often used to represent the user's selection."],["Scripts can only access the selection of the user who is running them within the bound document."],["The `getRangeElements()` method retrieves all elements within the range, including partially selected text elements."],["The `getSelectedElements()` method is deprecated and has been replaced by `getRangeElements()`."]]],[]]