עטיפה של Element
עם אפשרות להיסט התחלה וסיום. ההיסטים האלה מאפשרים לייצג טווח תווים בתוך רכיב Text
בתוצאות חיפוש, בבחירות במסמכים ובטווחים עם שם.
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
get | Element | הפונקציה מקבלת את הערך של Element שתואם ל-Range הזה. |
get | Integer | הפונקציה מקבלת את המיקום של סוף טווח חלקי בתוך רכיב הטווח. |
get | Integer | הפונקציה מקבלת את המיקום של תחילת טווח חלקי בתוך רכיב הטווח. |
is | Boolean | קובע אם רכיב הטווח הזה מכסה את כל הרכיב או בחירה חלקית של התווים שלו. |
מסמכים מפורטים
get Element()
הפונקציה מקבלת את הערך של 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 End Offset Inclusive()
הפונקציה מקבלת את המיקום של סוף טווח חלקי בתוך רכיב הטווח. אם האלמנט הוא Text
ו-is
מחזיר true
, ההיסט הוא מספר התווים לפני התו האחרון בטווח (כלומר, האינדקס של התו האחרון בטווח). בכל מקרה אחר, השיטה מחזירה את הערך -1
.
חזרה
Integer
– עבור רכיבי Text
, מספר התו לפני התו האחרון בטווח. עבור רכיבים אחרים, -1
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Start Offset()
הפונקציה מקבלת את המיקום של תחילת טווח חלקי בתוך רכיב הטווח. אם האלמנט הוא Text
ו-is
מחזיר true
, ההיסט הוא מספר התווים לפני תחילת הטווח (כלומר, האינדקס של התו הראשון בטווח). בכל מקרה אחר, השיטה מחזירה את הערך -1
.
חזרה
Integer
— עבור רכיבי Text
, מספר התווים לפני תחילת הטווח. עבור רכיבים אחרים, -1
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Partial()
קובע אם רכיב הטווח הזה מכסה את כל הרכיב או בחירה חלקית של התווים שלו. אפשר לקבוע את ההתחלה והסיום של טווח של רכיב טווח חלקי באמצעות get
ו-get
, בהתאמה.
חזרה
Boolean
— true
אם הרכיב נכלל באופן חלקי, false
אם לא
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents