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

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

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

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

المَعلمات

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

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

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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");

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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)');

المَعلمات

الاسم	Type	الوصف
`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])');

المَعلمات

الاسم	Type	الوصف
`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");

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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');

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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");

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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