تمت ترجمة هذه الصفحة بواسطة 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`	لضبط الخلفية على لون نموذج أحمر أخضر أزرق محدد.
`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 (جداول بيانات 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)`

لضبط الخلفية على لون نموذج أحمر أخضر أزرق محدد. هذا برنامج تضمين ملائم حول مكالمة 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 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 في قائمة النطاقات.

وقد تم توضيح أنماط التنسيق المقبولة في دليل تنسيق واجهة برمجة تطبيقات "جداول بيانات Google" وتاريخ تنسيقها.

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 في قائمة النطاقات. يمكن أن تكون القيمة رقمية أو سلسلة أو منطقية أو تاريخ. إذا كان يبدأ بـ 'ISBN#39؛ فإنه يتم تفسيره كصيغة.

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

راجع أيضًا

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