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.

ملاحظة: يقدّم هذا الإجراء طريقة لاختيار عدّة نطاقات.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

الإرجاع

RangeList: قائمة النطاقات النشطة لتسلسلها

التفويض

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

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

---

breakApart()

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

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

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

الإرجاع

RangeList: قائمة النطاقات هذه، لإنشاء سلاسل.

التفويض

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

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

---

clear()

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

const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق، مع إبقاء التنسيق سليمًا.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق

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

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق

const sheet = SpreadsheetApp.getActiveSheet();
const 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.

const 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)

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

const 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)

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

const 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()

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

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

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

const 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();

const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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).

const sheet = SpreadsheetApp.getActiveSheet();
const 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 (بدون تغيير).

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق.

const sheet = SpreadsheetApp.getActiveSheet();
const 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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاق أم لا

const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 في قائمة النطاقات. يمكن أن تكون القيمة رقمية أو تسلسلية أو منطقية أو تاريخًا. إذا كانت تبدأ بعلامة "="، يتم تفسيرها على أنّها صيغة.

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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()

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

ملاحظة: إذا كان النص المقتطع الناتج يبدأ بحرف "+" أو "=" ، سيظل النص قيمة سلسلة ولا يتم تفسيره كصيغة.

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

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

const 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'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

الإرجاع

RangeList: قائمة النطاقات هذه، لإنشاء سلاسل.

التفويض

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

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