Class NamedRange

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

פרמטרים

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