Class 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 בטווח list.
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});

פרמטרים

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

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

שםסוגתיאור
commentsOnlyBooleanהאם לנקות רק את התגובות.
contentsOnlyBooleanהאם לנקות רק את התוכן.
formatOnlyBooleanהאם לנקות רק את הפורמט. שימו לב: ניקוי הפורמט מנקה גם את הכללים לאימות נתונים.
validationsOnlyBooleanהאם להסיר רק כללים לאימות נתונים.
skipFilteredRowsBooleanהאם להימנע מניקוי שורות מסוננות.

חזרה

‫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');

פרמטרים

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

חזרה

‫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');

פרמטרים

שםסוגתיאור
checkedValueObjectהערך שמסומן בתיבת הסימון לאימות הנתונים.
uncheckedValueObjectהערך של תיבת הסימון כשהיא לא מסומנת, לצורך אימות הנתונים.

חזרה

‫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');

פרמטרים

שםסוגתיאור
colorStringקוד צבע הרקע בסימון 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);

פרמטרים

שםסוגתיאור
redIntegerהערך של האדום בסימון RGB.
greenIntegerהערך הירוק בסימון RGB.
blueIntegerהערך של הכחול בסימון 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);

פרמטרים

שםסוגתיאור
topBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
leftBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
bottomBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
rightBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
verticalBoolean‫true לגבולות אנכיים פנימיים, false ללא גבולות, null ללא שינוי.
horizontalBoolean‫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,
);

פרמטרים

שםסוגתיאור
topBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
leftBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
bottomBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
rightBoolean‫true לגבול, false ללא גבול, null ללא שינוי.
verticalBoolean‫true לגבולות אנכיים פנימיים, false ללא גבולות, null ללא שינוי.
horizontalBoolean‫true לגבולות אופקיים פנימיים, false ללא גבולות, null ללא שינוי.
colorStringצבע הגבול בסימון CSS כמו '#ffffff' או 'white', null לצבע ברירת מחדל (שחור).
styleBorderStyleהסגנון של הגבולות, 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');

פרמטרים

שםסוגתיאור
colorStringצבע הגופן בסימון 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');

פרמטרים

שםסוגתיאור
fontFamilyStringמשפחת הגופנים להגדרה. ערך של 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');

פרמטרים

שםסוגתיאור
fontLineStringסגנון הקו של הגופן, '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);

פרמטרים

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

חזרה

‫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');

פרמטרים

שםסוגתיאור
fontStyleStringסגנון הגופן, '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');

פרמטרים

שםסוגתיאור
fontWeightStringעובי הגופן, '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)');

פרמטרים

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

חזרה

‫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])');

פרמטרים

שםסוגתיאור
formulaStringנוסחה של מחרוזת.

חזרה

‫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');

פרמטרים

שםסוגתיאור
alignmentStringהיישור, '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');

פרמטרים

שםסוגתיאור
noteStringהטקסט של ההערה שרוצים להגדיר. ערך של 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');

פרמטרים

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

חזרה

‫RangeList — רשימת הטווחים הזו, לשרשור.

אישור

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

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

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

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

פרמטרים

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

חזרה

‫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);

פרמטרים

שםסוגתיאור
directionTextDirectionכיוון הטקסט הרצוי. אם 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);

פרמטרים

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

חזרה

‫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);

פרמטרים

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

חזרה

‫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');

פרמטרים

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

חזרה

‫RangeList — רשימת הטווחים הזו, לשרשור.

אישור

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

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

setVerticalText(isVertical)

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

// 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);

פרמטרים

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

חזרה

‫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);

פרמטרים

שםסוגתיאור
isWrapEnabledBooleanהאם להפעיל גלישת טקסט או לא.

חזרה

‫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);

פרמטרים

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

חזרה

‫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

ראה גם

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