Class NamedRange

NamedRange

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

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');
}

פרמטרים

שםסוגתיאור
nameStringהשם החדש של טווח התאים בעל השם.

חזרה

‫NamedRange — הטווח שהשם שלו הוגדר על ידי הקריאה

אישור

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

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

setRange(range)

הגדרה או עדכון של הטווח של טווח התאים בעל השם הזה.

פרמטרים

שםסוגתיאור
rangeRangeהטווח בגיליון האלקטרוני שרוצים לשייך לטווח התאים בעל השם.

חזרה

‫NamedRange – טווח התאים בעל השם שעבורו הוגדר טווח התאים בגיליון האלקטרוני

אישור

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

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