Class RangeList

RangeList

אוסף של מכונה אחת או יותר של Range באותו גיליון. אפשר להשתמש בכיתה הזו כדי להחיל פעולות על אוספים של טווחים או תאים לא סמוכים.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
activate()	RangeList	בוחרים את רשימת המכונות של Range.
breakApart()	RangeList	מפרקים שוב את כל התאים הממוזגים אופקית או אנכית שכלולים ברשימת הטווחים לתאים נפרדים.
check()	RangeList	שינוי המצב של תיבות הסימון בטווח ל'מסומנות'.
clear()	RangeList	הפונקציה מנקה את טווח התוכן, הפורמטים וכללי אימות הנתונים של כל Range ברשימת הטווחים.
clear(options)	RangeList	הפונקציה מנקה את טווח התוכן, הפורמט, כללי אימות הנתונים והתגובות, כפי שצוין באפשרויות הנתונות.
clearContent()	RangeList	הפונקציה מנקה את התוכן של כל Range ברשימת הטווחים, בלי לשנות את הפורמט.
clearDataValidations()	RangeList	מחיקת כללי אימות הנתונים של כל Range ברשימת הטווחים.
clearFormat()	RangeList	ניקוי עיצוב הטקסט של כל Range ברשימת התחומים.
clearNote()	RangeList	מחיקת ההערה של כל Range ברשימת הטווחים.
getRanges()	Range[]	הפונקציה מחזירה רשימה של מכונה אחת או יותר מסוג Range באותו גיליון.
insertCheckboxes()	RangeList	הפונקציה מוסיפה תיבות סימון לכל תא בטווח, שמוגדרות כ-true לסימון וכ-false לביטול הסימון.
insertCheckboxes(checkedValue)	RangeList	הוספת תיבות סימון לכל תא בטווח, עם ערך מותאם אישית לתיבות מסומנות ומחרוזת ריקה לתיבות לא מסומנות.
insertCheckboxes(checkedValue, uncheckedValue)	RangeList	הוספת תיבות סימון לכל תא בטווח, עם הגדרות של ערכים מותאמים אישית למצבים 'מסומן' ו'לא מסומן'.
removeCheckboxes()	RangeList	הסרת כל תיבות הסימון מהטווח.
setBackground(color)	RangeList	הגדרת צבע הרקע של כל Range ברשימת הטווחים.
setBackgroundRGB(red, green, blue)	RangeList	הגדרת הרקע לצבע ה-RGB שצוין.
setBorder(top, left, bottom, right, vertical, horizontal)	RangeList	הגדרת מאפיין הגבול לכל Range ברשימת הטווחים.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	RangeList	הגדרת מאפיין הגבול עם צבע ו/או סגנון לכל Range ברשימת הטווח.
setFontColor(color)	RangeList	הגדרת צבע הגופן של כל Range ברשימת הטווחים.
setFontFamily(fontFamily)	RangeList	הגדרת משפחת הגופן לכל Range ברשימת הטווח.
setFontLine(fontLine)	RangeList	הגדרת סגנון קו הגופן לכל Range ברשימת הטווחים.
setFontSize(size)	RangeList	הגדרת גודל הגופן (בנקודות) של כל Range ברשימת הטווחים.
setFontStyle(fontStyle)	RangeList	מגדירים את סגנון הגופן של כל Range ברשימת הטווחים.
setFontWeight(fontWeight)	RangeList	מגדירים את עובי הגופן של כל Range ברשימת הטווחים.
setFormula(formula)	RangeList	הנוסחה מתעדכנת לכל Range ברשימת הטווחים.
setFormulaR1C1(formula)	RangeList	הנוסחה מתעדכנת לכל Range ברשימת הטווחים.
setHorizontalAlignment(alignment)	RangeList	מגדירים את היישור האופקי של כל Range ברשימת הטווחים.
setNote(note)	RangeList	הגדרת טקסט הפתק לכל Range ברשימת התחומים.
setNumberFormat(numberFormat)	RangeList	הגדרת הפורמט של המספר או התאריך לכל Range ברשימת הטווחים.
setShowHyperlink(showHyperlink)	RangeList	מגדיר אם לכל Range ברשימת הטווח יוצגו היפר-קישורים.
setTextDirection(direction)	RangeList	הגדרת כיוון הטקסט של התאים בכל Range ברשימת הטווחים.
setTextRotation(degrees)	RangeList	הגדרת הגדרות הטקסט לסיבוב התאים בכל Range ברשימת הטווחים.
setValue(value)	RangeList	מגדירה את הערך של כל Range ברשימת הטווחים.
setVerticalAlignment(alignment)	RangeList	מגדירים את היישור האנכי של כל Range ברשימת הטווחים.
setVerticalText(isVertical)	RangeList	מגדיר אם הטקסט של התאים של כל Range ברשימה של הטווחים יהיה מוערם או לא.
setWrap(isWrapEnabled)	RangeList	מגדירים כיווץ טקסט לכל Range ברשימת הטווחים.
setWrapStrategy(strategy)	RangeList	הגדרת אסטרטגיית הגלישה של הטקסט לכל Range ברשימת התחומים.
trimWhitespace()	RangeList	חיתוך הרווחים הלבנים (כמו רווחים, טאבים או שורות חדשות) בכל תא ברשימת הטווח.
uncheck()	RangeList	שינוי המצב של תיבות הסימון בטווח ל'לא מסומנות'.

מסמכים מפורטים

activate()

בוחרים את רשימת המכונות של Range. הטווח האחרון ברשימה מוגדר כ-active range.

הערה: כך אפשר לבחור כמה טווחים בו-זמנית.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

חזרה

RangeList – רשימת הטווחים הפעילים, לצורך קישור.

אישור

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

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

---

breakApart()

מפרקים שוב את כל התאים הממוזגים אופקית או אנכית שכלולים ברשימת הטווחים לתאים נפרדים.

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

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

check()

שינוי המצב של תיבות הסימון בטווח ל'מסומן'. התאים בטווח שלא מכילים כרגע את הערך המוגדר כ'מסומן' או כ'לא מסומן' יישארו ללא שינוי.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clear()

הפונקציה מנקה את טווח התוכן, הפורמטים וכללי אימות הנתונים של כל Range ברשימת הטווחים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clear(options)

הפונקציה מנקה את טווח התוכן, הפורמט, כללי אימות הנתונים והתגובות, כפי שצוין באפשרויות הנתונות. כברירת מחדל, כל הנתונים נמחקים.

// The code below clears the contents of the following ranges A:A and C:C in the
// active sheet, but preserves the format, data validation rules, and comments.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

פרמטרים

שם	סוג	תיאור
options	Object	אובייקט JavaScript שמציין פרמטרים מתקדמים, כפי שמפורטים בהמשך.

פרמטרים מתקדמים

שם	סוג	תיאור
commentsOnly	Boolean	האם לנקות רק את התגובות.
contentsOnly	Boolean	אם לנקות רק את התוכן.
formatOnly	Boolean	אם לנקות רק את העיצוב. לתשומת ליבכם: ניקוי העיצוב מנקה גם את כללי אימות הנתונים.
validationsOnly	Boolean	אם למחוק רק את הכללים לאימות נתונים.
skipFilteredRows	Boolean	אם להימנע מניקוי של שורות מסוננות.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clearContent()

הפונקציה מנקה את התוכן של כל Range ברשימת הטווחים, בלי לשנות את הפורמט.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clearDataValidations()

מחיקת כללי אימות הנתונים של כל Range ברשימת הטווחים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clearFormat()

ניקוי עיצוב הטקסט של כל Range ברשימת התחומים.

הפעולה הזו מנקה את פורמט הטקסט בכל טווח, אבל לא מאפסת כללי פורמט של מספרים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

clearNote()

מחיקת ההערה של כל Range ברשימת הטווחים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

getRanges()

הפונקציה מחזירה רשימה של מכונה אחת או יותר מסוג Range באותו גיליון.

חזרה

Range[] — רשימת הטווחים.

אישור

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

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

---

insertCheckboxes()

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

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'true' for checked and 'false' for unchecked. Also, sets the value of each
// cell in the ranges D4 and E6 to 'false'.
rangeList.insertCheckboxes();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

insertCheckboxes(checkedValue)

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

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and the empty string for unchecked. Also, sets the value of
// each cell in the ranges D4 and E6 to the empty string.
rangeList.insertCheckboxes('yes');

פרמטרים

שם	סוג	תיאור
checkedValue	Object	הערך המסומן לאימות הנתונים של תיבת הסימון.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

insertCheckboxes(checkedValue, uncheckedValue)

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

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell
// in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

פרמטרים

שם	סוג	תיאור
checkedValue	Object	הערך המסומן לאימות הנתונים של תיבת הסימון.
uncheckedValue	Object	הערך שלא מסומן לאימות הנתונים של תיבת הסימון.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

removeCheckboxes()

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

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their
// value.
rangeList1.removeCheckboxes();

const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear
// their value.
rangeList2.removeCheckboxes();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setBackground(color)

הגדרת צבע הרקע של כל Range ברשימת הטווחים. הצבע מיוצג בסימן CSS, למשל '#ffffff' או 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

פרמטרים

שם	סוג	תיאור
color	String	קוד צבע הרקע בסימון CSS, כמו '#ffffff' או 'white'. ערך null מאפס את הצבע.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setBackgroundRGB(red, green, blue)

הגדרת הרקע לצבע ה-RGB שצוין. זוהי חבילה נוחה שמקיפה קריאה ל-setBackground(color).

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

פרמטרים

שם	סוג	תיאור
red	Integer	ערך האדום בסימון RGB.
green	Integer	הערך הירוק בסימון RGB.
blue	Integer	ערך הכחול בסימון RGB.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal)

הגדרת מאפיין הגבול לכל Range ברשימת הטווחים. הערכים החוקיים הם true (מופעל), false (מושבת) ו-null (ללא שינוי).

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves
// the left and right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

פרמטרים

שם	סוג	תיאור
top	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
left	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
bottom	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
right	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
vertical	Boolean	true לגבולות אנכיים פנימיים, false ללא גבולות, null ללא שינוי.
horizontal	Boolean	true לגבולות אופקיים פנימיים, false ללא גבולות, null ללא שינוי.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

הגדרת מאפיין הגבול עם צבע ו/או סגנון לכל Range ברשימת הטווח. הערכים החוקיים הם true (מופעל), false (מושבת) ו-null (ללא שינוי). הצבע מיוצג בתחביר CSS, לדוגמה '#ffffff' או 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged
// of the ranges A2:B4 and C1:D4. Also sets the color to 'red', and the border
// to 'DASHED'.
rangeList.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

פרמטרים

שם	סוג	תיאור
top	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
left	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
bottom	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
right	Boolean	true לגבול, false ללא גבול, null ללא שינוי.
vertical	Boolean	true לגבולות אנכיים פנימיים, false ללא גבולות, null ללא שינוי.
horizontal	Boolean	true לגבולות אופקיים פנימיים, false ללא גבולות, null ללא שינוי.
color	String	צבע הגבול בסימן CSS, כמו '#ffffff' או 'white', null לצבע ברירת המחדל (שחור).
style	BorderStyle	הסגנון של הגבולות, null לסגנון ברירת המחדל (אחיד).

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontColor(color)

הגדרת צבע הגופן של כל Range ברשימת הטווחים. הצבע מיוצג בסימון CSS, למשל '#ffffff' או 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

פרמטרים

שם	סוג	תיאור
color	String	צבע הגופן בסימן CSS, כמו '#ffffff' או 'white'. הערך null מאפס את הצבע.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontFamily(fontFamily)

הגדרת משפחת הגופן לכל Range ברשימת הטווח. משפחת הגופנים מתוארת באמצעות מזהה מחרוזת, כמו Arial או Roboto.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

פרמטרים

שם	סוג	תיאור
fontFamily	String	משפחת הגופנים שתוגדר. ערך null מאפס את משפחת הגופנים.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontLine(fontLine)

הגדרת סגנון קו הגופן לכל Range ברשימת הטווחים. אפשרויות סגנון הקו הם 'underline',‏ 'line-through' או 'none'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

פרמטרים

שם	סוג	תיאור
fontLine	String	סגנון הקו של הגופן, 'underline',‏ 'line-through' או 'none'. ערך null מאפס את סגנון הקו של הגופן.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontSize(size)

הגדרת גודל הגופן (בנקודות) של כל Range ברשימת הטווחים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

פרמטרים

שם	סוג	תיאור
size	Integer	גודל גופן בנקודות.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontStyle(fontStyle)

מגדירים את סגנון הגופן של כל Range ברשימת הטווחים. אפשרויות סגנון הגופן הן 'italic' או 'normal'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle('italic');

פרמטרים

שם	סוג	תיאור
fontStyle	String	סגנון הגופן, 'italic' או 'normal'. ערך null מאפס את סגנון הגופן.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFontWeight(fontWeight)

מגדירים את עובי הגופן של כל Range ברשימת הטווחים. אפשרויות משקל הגופן הן 'normal' או 'bold'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

פרמטרים

שם	סוג	תיאור
fontWeight	String	עובי הגופן, 'bold' או 'normal'. ערך null מחזיר את עובי הגופן להגדרה המקורית.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFormula(formula)

הנוסחה מתעדכנת לכל Range ברשימת הטווחים. הנוסחה צריכה להיות בסימן A1.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

פרמטרים

שם	סוג	תיאור
formula	String	מחרוזת שמייצגת את הנוסחה שרוצים להגדיר.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setFormulaR1C1(formula)

הנוסחה מתעדכנת לכל Range ברשימת הטווחים. הנוסחה שצוינה צריכה להיות בסימן R1C1.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

פרמטרים

שם	סוג	תיאור
formula	String	נוסחת מחרוזת.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setHorizontalAlignment(alignment)

מגדירים את היישור האופקי של כל Range ברשימת הטווחים. אפשרויות היישור הן 'left',‏ 'center' או 'right'.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment('center');

פרמטרים

שם	סוג	תיאור
alignment	String	היישור, 'left', ‏ 'center' או 'normal'. הערך null מאפס את היישור.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setNote(note)

הגדרת טקסט הפתק לכל Range ברשימת התחומים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

פרמטרים

שם	סוג	תיאור
note	String	טקסט ההערה להגדרה. ערך null מסיר את ההערה.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setNumberFormat(numberFormat)

הגדרת הפורמט של המספר או התאריך לכל Range ברשימת הטווחים.

דפוסי העיצוב המותרים מתוארים במדריך לעיצוב תאריכים ומספרים ב-Sheets API.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

פרמטרים

שם	סוג	תיאור
numberFormat	String	מחרוזת של פורמט מספר.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setShowHyperlink(showHyperlink)

מגדיר אם לכל Range ברשימת הטווח יוצגו היפר-קישורים.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

פרמטרים

שם	סוג	תיאור
showHyperlink	Boolean	אם להציג את ההיפר-קישור או לא.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setTextDirection(direction)

הגדרת כיוון הטקסט של התאים בכל Range ברשימת הטווחים. אם הכיוון שצוין הוא null, המערכת מסיקה את הכיוון ומגדירה אותו.

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

פרמטרים

שם	סוג	תיאור
direction	TextDirection	כיוון הטקסט הרצוי. אם הערך הוא null, הכיוון משוער לפני ההגדרה.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setTextRotation(degrees)

הגדרת הגדרות הטקסט לסיבוב התאים בכל Range ברשימת הטווחים. הקלט תואם לזווית שבין כיוון הטקסט הרגיל לבין הכיוון הרצוי. קלט של אפס מציין שהטקסט מוגדר לכיוון הרגיל.

בכיוון טקסט משמאל לימין, זוויות חיוביות הן בכיוון נגד כיוון השעון, ואילו בכיוון טקסט מימין לשמאל הן בכיוון השעון.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

פרמטרים

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

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setValue(value)

מגדירה את הערך של כל Range ברשימת הטווחים. הערך יכול להיות מספר, מחרוזת, ערך בוליאני או תאריך. אם הוא מתחיל ב-'‎=', הוא מפורש כנוסחה.

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

פרמטרים

שם	סוג	תיאור
value	Object	הערך של הטווח.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setVerticalAlignment(alignment)

מגדירים את היישור האנכי של כל Range ברשימת הטווחים. אפשרויות היישור הן 'top', ‏ 'middle' או 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

פרמטרים

שם	סוג	תיאור
alignment	String	היישור, 'top', ‏ 'middle' או 'bottom'. הערך null מאפס את היישור.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setVerticalText(isVertical)

מגדיר אם הטקסט של התאים של כל Range ברשימה של הטווחים יהיה מוערם או לא. אם הטקסט נערם אנכית, המערכת מתעלמת מהגדרת סיבוב הטקסט ב-degrees.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

פרמטרים

שם	סוג	תיאור
isVertical	Boolean	האם להציב את הטקסט בערימה או לא.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setWrap(isWrapEnabled)

מגדירים כיווץ טקסט לכל Range ברשימת הטווחים. התאים עם האפשרות 'התאמה אוטומטית' מותאמים לגודל כדי להציג את התוכן המלא שלהם. בתאים שבהם האפשרות 'התאמת טקסט' מושבתת, הטקסט מוצג בתא במלואו, בלי שינוי הגודל או מעבר לשורות נוספות.

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

פרמטרים

שם	סוג	תיאור
isWrapEnabled	Boolean	אם הטקסט יגולגל או לא.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

setWrapStrategy(strategy)

הגדרת אסטרטגיית הגלישה של הטקסט לכל Range ברשימת התחומים.

// Sets the list of ranges to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

פרמטרים

שם	סוג	תיאור
strategy	WrapStrategy	אסטרטגיית הגלישה הרצויה.

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

---

trimWhitespace()

חיתוך הרווחים הלבנים (כמו רווחים, טאבים או שורות חדשות) בכל תא ברשימת הטווח. הפונקציה מסירה את כל הרווחים הלבנים מתחילת הטקסט של כל תא ומסוף הטקסט שלו, ומצמצמת כל רצף משנה של תווי רווח שנותרו לרווח יחיד.

הערה: אם הטקסט שנחתך בתוצאה מתחיל בתווית '+' או '=', הטקסט יישאר כערך מחרוזת ולא יפורש כנוסחה.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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

ראה גם

• Range.trimWhitespace()

---

uncheck()

שינוי המצב של תיבות הסימון בטווח ל'לא מסומנות'. התאים בטווח שלא מכילים כרגע את הערך המוגדר של 'מסומן' או 'לא מסומן' יישארו ללא שינוי.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'unchecked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

חזרה

RangeList – רשימת הטווחים הזו, לצורך שרשור.

אישור

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

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