עטיפה של Element עם אפשרות להיסט התחלה וסיום. ההיסטים האלה מאפשרים לייצג טווח תווים בתוך רכיב Text בתוצאות חיפוש, בבחירות במסמכים ובטווחים עם שם.
Methods
| שיטה | סוג הערך המוחזר | תיאור קצר | 
|---|---|---|
| get | Element | הפונקציה מקבלת את הערך של Elementשתואם ל-Rangeהזה. | 
| get | Integer | הפונקציה מקבלת את המיקום של סוף טווח חלקי בתוך רכיב הטווח. | 
| get | Integer | הפונקציה מקבלת את המיקום של תחילת טווח חלקי בתוך רכיב הטווח. | 
| is | Boolean | קובע אם רכיב הטווח הזה מכסה את כל הרכיב או בחירה חלקית של התווים שלו. | 
מסמכים מפורטים
get
הפונקציה מקבלת את הערך של Element שתואם ל-Range הזה.
const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0]; // Log debug information about a range element. Logger.log(`Element type: ${rangeElement.getElement().getType()}`); if (rangeElement.isPartial()) { Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`); Logger.log( `The character range ends at ${rangeElement.getEndOffsetInclusive()}`, ); } else { Logger.log('The entire range element is included.'); }
חזרה
Element – הרכיב שתואם ל-Range הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
הפונקציה מקבלת את המיקום של סוף טווח חלקי בתוך רכיב הטווח. אם האלמנט הוא Text ו-is מחזיר true, ההיסט הוא מספר התווים לפני התו האחרון בטווח (כלומר, האינדקס של התו האחרון בטווח). בכל מקרה אחר, השיטה מחזירה את הערך -1.
חזרה
Integer – עבור רכיבי Text, מספר התו לפני התו האחרון בטווח. עבור רכיבים אחרים, -1
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
get
הפונקציה מקבלת את המיקום של תחילת טווח חלקי בתוך רכיב הטווח. אם האלמנט הוא Text ו-is מחזיר true, ההיסט הוא מספר התווים לפני תחילת הטווח (כלומר, האינדקס של התו הראשון בטווח). בכל מקרה אחר, השיטה מחזירה את הערך -1.
חזרה
Integer — עבור רכיבי Text, מספר התווים לפני תחילת הטווח. עבור רכיבים אחרים, -1
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents
is
קובע אם רכיב הטווח הזה מכסה את כל הרכיב או בחירה חלקית של התווים שלו. אפשר לקבוע את ההתחלה והסיום של טווח של רכיב טווח חלקי באמצעות get ו-get, בהתאמה.
חזרה
Boolean — true אם הרכיב נכלל באופן חלקי, false אם לא
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/documents.currentonly
- 
https://www.googleapis.com/auth/documents