Class RangeList

RangeList

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

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
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.

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

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

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

החזרות

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

הרשאות

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

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

---

breakApart()

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

החזרות

RangeList - רשימת הטווחים הזו לשרשור.

הרשאות

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

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

---

clear()

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים ומשאירה את העיצוב ללא שינוי.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים.

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

var 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)

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

var 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)

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

var 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()

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

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

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

var 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();

var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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).

var sheet = SpreadsheetApp.getActiveSheet();
var 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 (ללא שינוי).

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים יציג היפר-קישורים.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים. הערך יכול להיות מספרי, מחרוזת, ערך בוליאני או תאריך. אם הוא מתחיל ב-'=', המערכת מפרשת אותו כנוסחה.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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 ברשימת הטווחים. אם הטקסט מוערם במאונך, המערכת מתעלמת מהגדרת סיבוב הטקסט במעלות.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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()

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

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

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

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

var 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

החזרות

RangeList - רשימת הטווחים הזו לשרשור.

הרשאות

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

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