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

פרמטרים

שםסוגתיאור
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