דף זה תורגם על ידי Cloud Translation API.

Class 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