יצירה, גישה ושינוי של טווחים בעלי שם בגיליון אלקטרוני. טווחים בעלי שם הם טווחים שמשויכים להם כינויי מחרוזות. אפשר להציג ולערוך אותם בממשק המשתמש של Sheets בתפריט נתונים > טווחים בעלי שם....
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getName() | String | הפונקציה מקבלת את השם של הטווח בעל השם הזה. |
getRange() | Range | הפונקציה מקבלת את הטווח שאליו מפנה הטווח בעל השם. |
remove() | void | מחיקת הטווח בעל השם הזה. |
setName(name) | NamedRange | הגדרה/עדכון של השם של הטווח בעל השם. |
setRange(range) | NamedRange | הגדרה/עדכון של הטווח עבור הטווח בעל השם. |
תיעוד מפורט
getName()
הפונקציה מקבלת את השם של הטווח בעל השם הזה.
החזרות
String
– השם של הטווח בעל השם
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
remove()
מחיקת הטווח בעל השם הזה.
// The code below deletes all the named ranges in the spreadsheet. var namedRanges = SpreadsheetApp.getActive().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { namedRanges[i].remove(); }
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
הגדרה/עדכון של השם של הטווח בעל השם.
// The code below updates the name for the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName("UpdatedNamedRange"); }
פרמטרים
שם | תיאור | התיאור |
---|---|---|
name | String | השם החדש של הטווח בעל השם. |
החזרות
NamedRange
– הטווח שהשם שלו הוגדר על ידי השיחה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRange(range)
הגדרה/עדכון של הטווח עבור הטווח בעל השם.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
range | Range | הטווח של הגיליון האלקטרוני שיש לשייך לטווח בעל השם הזה. |
החזרות
NamedRange
- הטווח בעל השם שעבורו הוגדר הטווח של הגיליון האלקטרוני
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets