Class NamedRange

NamedRange

יצירה, גישה ושינוי של טווחי תאים בעלי שם בגיליון אלקטרוני. טווחי תאים בעלי שם הם טווחים שמשויכים אליהם כינויים של מחרוזות. אפשר להציג ולערוך אותם דרך ממשק המשתמש של Sheets, בתפריט נתונים > Intervals with names.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let 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.
const 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