דף זה תורגם על ידי Cloud Translation API.

Class NamedRange

יצירה, גישה ושינוי של טווחים בעלי שם בגיליון אלקטרוני. טווחים בעלי שם הם טווחים שמשויכים להם כינויי מחרוזות. אפשר להציג ולערוך אותם בממשק המשתמש של 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()`

הפונקציה מקבלת את הטווח שאליו מפנה הטווח בעל השם.

החזרות

Range – הטווח של הגיליון האלקטרוני שמשויך לטווח בעל השם הזה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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