דף זה תורגם על ידי 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