این صفحه به‌وسیله ‏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()`

دوباره تمام سلول های ادغام شده به صورت افقی یا عمودی موجود در لیست محدوده را به سلول های جداگانه تقسیم کنید.

فراخوانی این تابع در یک لیست محدوده معادل انتخاب مجموعه ای از محدوده ها و انتخاب گزینه منوی Format > Merge > Unmerge 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`	یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند.

پارامترهای پیشرفته

نام	تایپ کنید	توضیحات
`commentsOnly`	`Boolean`	اینکه آیا فقط نظرات پاک شود.
`contentsOnly`	`Boolean`	آیا فقط محتویات پاک شود.
`formatOnly`	`Boolean`	اینکه آیا فقط قالب پاک شود. توجه داشته باشید که فرمت پاکسازی قوانین اعتبارسنجی داده ها را نیز پاک می کند.
`validationsOnly`	`Boolean`	اینکه آیا فقط قوانین اعتبارسنجی داده ها پاک شود.
`skipFilteredRows`	`Boolean`	آیا برای جلوگیری از پاک کردن ردیف های فیلتر شده.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`clearContent()`

محتوای هر Range را در لیست محدوده پاک می کند و قالب بندی را دست نخورده باقی می گذارد.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`clearDataValidations()`

قوانین اعتبارسنجی داده ها را برای هر Range در لیست محدوده پاک می کند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`clearFormat()`

قالب بندی متن را برای هر Range در لیست محدوده پاک می کند.

این کار قالب بندی متن را برای هر محدوده پاک می کند، اما هیچ قانون قالب بندی اعداد را بازنشانی نمی کند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`clearNote()`

یادداشت را برای هر Range در لیست محدوده پاک می کند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`getRanges()`

فهرستی از یک یا چند نمونه Range را در همان برگه برمی‌گرداند.

بازگشت

Range[] - فهرست محدوده ها.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`insertCheckboxes()`

چک باکس ها را در هر سلول در محدوده وارد می کند که با true برای علامت زده و false برای علامت نشده پیکربندی شده است. مقدار تمام سلول های محدوده را روی false قرار می دهد.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`insertCheckboxes(checkedValue)`

چک باکس ها را در هر سلول در محدوده وارد می کند که با یک مقدار سفارشی برای علامت گذاری شده و رشته خالی برای علامت گذاری نشده پیکربندی شده است. مقدار هر سلول در محدوده را روی رشته خالی تنظیم می کند.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

پارامترها

نام	تایپ کنید	توضیحات
`checkedValue`	`Object`	مقدار علامت‌گذاری شده برای تأیید اعتبار داده‌های کادر تأیید.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

چک باکس‌ها را در هر سلول در محدوده وارد می‌کند که با مقادیر سفارشی برای حالت‌های علامت‌گذاری شده و علامت‌نخورده پیکربندی شده است. مقدار هر سلول در محدوده را به مقدار سفارشی بدون علامت تنظیم می کند.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

پارامترها

نام	تایپ کنید	توضیحات
`checkedValue`	`Object`	مقدار علامت‌گذاری شده برای تأیید اعتبار داده‌های کادر تأیید.
`uncheckedValue`	`Object`	مقدار بدون علامت برای تأیید اعتبار داده‌های کادر تأیید.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`removeCheckboxes()`

تمام چک باکس ها را از محدوده حذف می کند. اعتبار داده‌های هر سلول را پاک می‌کند و اگر سلول حاوی مقدار علامت‌گذاری شده یا علامت‌نخورده باشد، مقدار آن را نیز پاک می‌کند.

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

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

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setBackground(color)`

رنگ پس زمینه را برای هر Range در لیست محدوده تنظیم می کند. رنگ در نماد CSS نشان داده شده است. به عنوان مثال، '#ffffff' یا 'white' .

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	کد رنگ پس زمینه در نماد CSS مانند `'#ffffff'` یا `'white'` . یک مقدار `null` رنگ را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setBackgroundRGB(red, green, blue)`

پس زمینه را روی رنگ RGB داده شده تنظیم می کند. این یک بسته بندی راحت در اطراف یک تماس setBackground(color) است.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

پارامترها

نام	تایپ کنید	توضیحات
`red`	`Integer`	مقدار قرمز در نماد RGB.
`green`	`Integer`	مقدار سبز در نماد RGB.
`blue`	`Integer`	مقدار آبی در نماد RGB.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

ویژگی حاشیه را برای هر Range در لیست محدوده تنظیم می کند. مقادیر معتبر true (روشن)، false (خاموش) و null (بدون تغییر) هستند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

پارامترها

نام	تایپ کنید	توضیحات
`top`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`left`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`bottom`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`right`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`vertical`	`Boolean`	`true` برای مرزهای عمودی داخلی، `false` برای هیچ، `null` برای بدون تغییر.
`horizontal`	`Boolean`	`true` برای مرزهای افقی داخلی، `false` برای هیچ، `null` برای بدون تغییر.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

ویژگی حاشیه را با رنگ و/یا سبک برای هر Range در لیست محدوده تنظیم می کند. مقادیر معتبر true (روشن)، false (خاموش) و null (بدون تغییر) هستند. رنگ در نماد CSS نشان داده شده است. به عنوان مثال، '#ffffff' یا 'white' .

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

پارامترها

نام	تایپ کنید	توضیحات
`top`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`left`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`bottom`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`right`	`Boolean`	`true` برای مرز، `false` برای هیچ، `null` برای بدون تغییر.
`vertical`	`Boolean`	`true` برای مرزهای عمودی داخلی، `false` برای هیچ، `null` برای بدون تغییر.
`horizontal`	`Boolean`	`true` برای مرزهای افقی داخلی، `false` برای هیچ، `null` برای بدون تغییر.
`color`	`String`	رنگ حاشیه در نماد CSS مانند `'#ffffff'` یا `'white'` ، برای رنگ پیش فرض `null` (سیاه).
`style`	`BorderStyle`	سبک برای حاشیه ها، `null` برای سبک پیش فرض (جامد).

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontColor(color)`

رنگ قلم را برای هر Range در لیست محدوده تنظیم می کند. رنگ در نماد CSS نشان داده شده است. به عنوان مثال، '#ffffff' یا 'white' .

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ فونت در نماد CSS مانند `'#ffffff'` یا `'white'` . یک مقدار `null` رنگ را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontFamily(fontFamily)`

خانواده فونت را برای هر Range در لیست محدوده تنظیم می کند. خانواده فونت با یک شناسه رشته مانند Arial یا Roboto توصیف می شود.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

پارامترها

نام	تایپ کنید	توضیحات
`fontFamily`	`String`	خانواده فونت برای تنظیم. یک مقدار `null` خانواده فونت را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontLine(fontLine)`

سبک خط فونت را برای هر Range در لیست محدوده تنظیم می کند. گزینه‌های سبک خط عبارتند از 'underline' ، 'line-through' یا 'none' .

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

پارامترها

نام	تایپ کنید	توضیحات
`fontLine`	`String`	سبک خط فونت، یا `'underline'` ، `'line-through'` ، یا `'none'` ; یک مقدار `null` سبک خط فونت را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontSize(size)`

اندازه قلم (به امتیاز) را برای هر Range در لیست محدوده تنظیم می کند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

پارامترها

نام	تایپ کنید	توضیحات
`size`	`Integer`	اندازه نقطه فونت

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontStyle(fontStyle)`

سبک قلم را برای هر Range در لیست محدوده تنظیم کنید. گزینه‌های سبک فونت 'italic' یا 'normal' هستند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle("italic");

پارامترها

نام	تایپ کنید	توضیحات
`fontStyle`	`String`	سبک فونت، `'italic'` یا `'normal'` ؛ یک مقدار `null` سبک فونت را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFontWeight(fontWeight)`

وزن قلم را برای هر Range در لیست محدوده تنظیم کنید. گزینه های وزن فونت 'normal' یا 'bold' هستند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

پارامترها

نام	تایپ کنید	توضیحات
`fontWeight`	`String`	وزن فونت، `'bold'` یا `'normal'` ؛ یک مقدار `null` وزن فونت را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFormula(formula)`

فرمول را برای هر Range در لیست محدوده به روز می کند. فرمول داده شده باید با نماد A1 باشد.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

پارامترها

نام	تایپ کنید	توضیحات
`formula`	`String`	رشته ای که فرمول تنظیم را نشان می دهد.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setFormulaR1C1(formula)`

فرمول را برای هر Range در لیست محدوده به روز می کند. فرمول داده شده باید با نماد R1C1 باشد.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

پارامترها

نام	تایپ کنید	توضیحات
`formula`	`String`	یک فرمول رشته ای

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setHorizontalAlignment(alignment)`

تراز افقی را برای هر Range در لیست محدوده تنظیم کنید. گزینه های تراز عبارتند از 'left' ، 'center' یا 'right' .

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment("center");

پارامترها

نام	تایپ کنید	توضیحات
`alignment`	`String`	تراز، یا `'left'` ، `'center'` یا `'normal'` ؛ یک مقدار `null` تراز را بازنشانی می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setNote(note)`

متن یادداشت را برای هر Range در لیست محدوده تنظیم می کند.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

پارامترها

نام	تایپ کنید	توضیحات
`note`	`String`	متن یادداشت برای تنظیم. یک مقدار `null` نت را حذف می کند.

بازگشت

RangeList - این فهرست محدوده، برای زنجیر.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`setNumberFormat(numberFormat)`

تعداد یا قالب تاریخ را برای هر Range در لیست محدوده تنظیم می کند.

الگوهای قالب‌بندی پذیرفته‌شده در راهنمای قالب‌بندی تاریخ و شماره API 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 در لیست محدوده تنظیم کنید. سلول‌هایی که Wrap را فعال کرده‌اند، تغییر اندازه می‌دهند تا محتوای کامل خود را نمایش دهند. سلول‌های دارای بسته‌بندی غیرفعال تا حد امکان در سلول بدون تغییر اندازه یا اجرای چندین خط نمایش داده می‌شوند.

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