אוסף של מופע אחד או יותר של 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()
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
כדאי לעיין גם בפרטים הבאים
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