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'; A הערך 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'; A הערך 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 API.

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'; A הערך 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