تمت ترجمة هذه الصفحة بواسطة 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()`

تقسيم جميع الخلايا المدموجة أفقيًا أو عموديًا الموجودة داخل قائمة النطاق إلى الخلايا الفردية مرة أخرى.

يعادل استدعاء هذه الدالة في قائمة نطاق تحديد مجموعة من النطاقات تحديد التنسيق > دمج > إلغاء دمج عنصر القائمة في "جداول بيانات Google"

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`check()`

تغيير حالة مربعات الاختيار في النطاق إلى "محدد". تتجاهل الخلايا في النطاق التي لا تحتوي حاليًا على القيمة المحدَّدة أو غير المحدَّدة التي تم ضبطها

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'checked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clear()`

محو نطاق المحتوى والتنسيقات وقواعد التحقق من صحة البيانات لكل Range في قائمة النطاق.

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clear(options)`

يؤدي هذا الإجراء إلى محو نطاق المحتوى والتنسيق وقواعد التحقق من صحة البيانات والتعليقات، كما هو محدّد في. الخيارات المحددة. ويتم محو جميع البيانات تلقائيًا.

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

المعلمات

الاسم	النوع	الوصف
`options`	`Object`	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

المعلمات المتقدمة

الاسم	النوع	الوصف
`commentsOnly`	`Boolean`	تحديد ما إذا كان سيتم محو التعليقات فقط
`contentsOnly`	`Boolean`	ما إذا كان سيتم محو المحتوى فقط أم لا.
`formatOnly`	`Boolean`	ما إذا كنت تريد محو التنسيق فقط أم لا لاحظ أن محو أيضًا على مسح قواعد التحقق من صحة البيانات.
`validationsOnly`	`Boolean`	ما إذا كان سيتم محو قواعد التحقق من صحة البيانات فقط.
`skipFilteredRows`	`Boolean`	ما إذا كان سيتم تجنُّب محو الصفوف التي تمت فلترتها.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clearContent()`

يؤدي إلى محو محتوى كل Range في قائمة النطاقات، مع ترك التنسيق سليمًا.

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clearDataValidations()`

يؤدي هذا الإجراء إلى محو قواعد التحقّق من صحة البيانات لكل Range في قائمة النطاقات.

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clearFormat()`

يؤدي هذا الإجراء إلى محو تنسيق النص لكل Range في قائمة النطاقات.

يؤدي هذا إلى محو تنسيق النص لكل نطاق، ولكنه لا يعيد ضبط أي قواعد لتنسيق الأرقام.

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`clearNote()`

يؤدي هذا الإجراء إلى محو الملاحظة لكل Range في قائمة النطاقات.

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`getRanges()`

عرض قائمة بحدث Range واحد أو أكثر في ورقة البيانات نفسها

الإرجاع

Range[] — قائمة النطاقات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`insertCheckboxes()`

إدراج مربعات اختيار في كل خلية في النطاق، مع ضبط الإعداد true على وضع التحديد تمت إزالة العلامة من المربّع false للحقل. تضبط قيمة كل الخلايا في النطاق على false.

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

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`insertCheckboxes(checkedValue)`

تدرج مربعات الاختيار في كل خلية في النطاق، مع ضبطها بقيمة مخصصة لما تم تحديده السلسلة الفارغة لإلغاء الاختيار. لتعيين قيمة كل خلية في النطاق إلى السلسلة الفارغة.

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

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

المعلمات

الاسم	النوع	الوصف
`checkedValue`	`Object`	القيمة التي تم وضع علامة عليها للتحقّق من صحة بيانات مربّع الاختيار.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

تدرج مربعات الاختيار في كل خلية في النطاق، مع ضبطها بقيم مخصصة وغير المحددة بعلامة. يتم ضبط قيمة كل خلية في النطاق على القيمة المخصّصة غير المحدّدة.

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

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

المعلمات

الاسم	النوع	الوصف
`checkedValue`	`Object`	القيمة التي تم وضع علامة عليها للتحقّق من صحة بيانات مربّع الاختيار.
`uncheckedValue`	`Object`	القيمة غير المحددة للتحقق من صحة بيانات مربع الاختيار.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`removeCheckboxes()`

إزالة جميع مربعات الاختيار من النطاق محو التحقق من صحة البيانات لكل خلية بالإضافة إلى ذلك يمحو قيمتها إذا كانت الخلية تحتوي على القيمة المحددة أو غير المحددة.

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

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

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

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

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setBackground(color)`

تضبط لون الخلفية لكل Range في قائمة النطاقات. يتم تمثيل اللون في في تدوين CSS؛ على سبيل المثال، '#ffffff' أو 'white'.

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

المعلمات

الاسم	النوع	الوصف
`color`	`String`	رمز لون الخلفية في ترميز CSS، مثل `'#ffffff'` أو `'white'` تؤدي القيمة `null` إلى إعادة ضبط اللون.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setBackgroundRGB(red, green, blue)`

لضبط الخلفية على لون RGB المحدّد. هذا برنامج تضمين مريح حول مكالمة setBackground(color).

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

المعلمات

الاسم	النوع	الوصف
`red`	`Integer`	القيمة الحمراء في تدوين النموذج اللوني أحمر أخضر أزرق.
`green`	`Integer`	القيمة الخضراء في تدوين النموذج اللوني أحمر أخضر أزرق.
`blue`	`Integer`	القيمة الزرقاء في تدوين النموذج اللوني أحمر أخضر أزرق.

الإرجاع

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'` CANNOT TRANSLATE تؤدي قيمة `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'`؛ CANNOT TRANSLATE تؤدي القيمة `null` إلى إعادة ضبط المحاذاة.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setNote(note)`

لضبط نص الملاحظة لكل Range في قائمة النطاقات.

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

المعلمات

الاسم	النوع	الوصف
`note`	`String`	نص الملاحظة المطلوب تعيينه؛ تؤدي القيمة `null` إلى إزالة الملاحظة.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setNumberFormat(numberFormat)`

تضبط هذه السياسة تنسيق الأرقام أو التاريخ لكل Range في قائمة النطاقات.

يتم توضيح أنماط التنسيق المقبولة في دليل تنسيق التاريخ والأرقام في Sheets API.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

المعلمات

الاسم	النوع	الوصف
`numberFormat`	`String`	سلسلة تنسيق الأرقام

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setShowHyperlink(showHyperlink)`

لضبط ما إذا كان يجب عرض روابط تشعّبية لكل Range في قائمة النطاق أم لا.

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

المعلمات

الاسم	النوع	الوصف
`showHyperlink`	`Boolean`	لتحديد ما إذا كان سيتم عرض الرابط التشعبي أم لا.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setTextDirection(direction)`

لضبط اتجاه النص للخلايا في كل Range في قائمة النطاقات. إذا الاتجاه المحدد هو null، فسيتم استنتاج الاتجاه ثم ضبطه.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

المعلمات

الاسم	النوع	الوصف
`direction`	`TextDirection`	اتجاه النص المطلوب؛ إذا تم استنتاج الاتجاه `null` قبل الإعداد.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setTextRotation(degrees)`

لضبط إعدادات تدوير النص للخلايا في كل Range في قائمة النطاقات. تشير رسالة الأشكال البيانية الإدخال مع الزاوية بين اتجاه النص القياسي والاتجاه المطلوب توجهك. يشير الإدخال صفر إلى أنه تم تعيين النص على الاتجاه القياسي.

ومن أجل اتجاه النص من اليسار إلى اليمين، تكون الزوايا الموجبة عكس اتجاه عقارب الساعة، بينما بالنسبة لليمين إلى اليسار تكون في اتجاه عقارب الساعة.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

المعلمات

الاسم	النوع	الوصف
`degrees`	`Integer`	الزاوية المطلوبة بين الاتجاه القياسي والاتجاه المطلوب. بالنسبة إلى النص من اليسار إلى اليمين، تكون الزوايا الموجبة عكس اتجاه عقارب الساعة.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setValue(value)`

تحدد قيمة كل Range في قائمة النطاقات. يمكن أن تكون القيمة رقمية أو سلسلة منطقية أو تاريخ. إذا كانت تبدأ بـ '=' يتم تفسيره على أنه معادلة.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

المعلمات

الاسم	النوع	الوصف
`value`	`Object`	قيمة النطاق.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setVerticalAlignment(alignment)`

اضبط المحاذاة العمودية لكل Range في قائمة النطاقات. خيارات المحاذاة هي 'top' أو 'middle' أو 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

المعلمات

الاسم	النوع	الوصف
`alignment`	`String`	المحاذاة، إما `'top'` أو `'middle'` أو `'bottom'`؛ CANNOT TRANSLATE تؤدي القيمة `null` إلى إعادة ضبط المحاذاة.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setVerticalText(isVertical)`

لتحديد ما إذا كان سيتم تكديس النص للخلايا لكل Range في النطاق أم لا الحالية. إذا تم تكديس النص عموديًا، فسيتم تجاهل إعداد تدوير النص درجة.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

المعلمات

الاسم	النوع	الوصف
`isVertical`	`Boolean`	تحديد ما إذا كان سيتم تكديس النص أم لا.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setWrap(isWrapEnabled)`

ضبط التفاف النص لكل Range في قائمة النطاقات. تغيير حجم الخلايا التي تم تفعيل الالتفاف بها لعرض محتواها بالكامل. يتم عرض الخلايا التي تم إيقاف التفافها قدر الإمكان في الخلية. بدون تغيير الحجم أو التشغيل إلى عدة أسطر.

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

المعلمات

الاسم	النوع	الوصف
`isWrapEnabled`	`Boolean`	ما إذا كان سيتم التفاف النص أم لا.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`setWrapStrategy(strategy)`

يتم ضبط استراتيجية التفاف النص لكل Range في قائمة النطاقات.

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

المعلمات

الاسم	النوع	الوصف
`strategy`	`WrapStrategy`	استراتيجية التغليف المطلوبة.

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`trimWhitespace()`

يزيل المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في قائمة النطاقات هذه. إزالة جميع المسافات البيضاء من بداية ونهاية نص كل خلية، وتقليل أي تسلسل فرعي المسافات البيضاء المتبقية في مسافة واحدة.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

انظر أيضًا

Range.trimWhitespace()

`uncheck()`

تغيير حالة مربعات الاختيار في النطاق إلى "غير محددة". تتجاهل الخلايا في النطاق التي لا تحتوي حاليًا على القيمة المحدَّدة أو غير المحدَّدة التي تم ضبطها

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

الإرجاع

RangeList — قائمة النطاقات هذه للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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