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

المعلمات

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

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

الاسمالنوعالوصف
commentsOnlyBooleanتحديد ما إذا كنت تريد محو التعليقات فقط
contentsOnlyBooleanما إذا كنت تريد محو المحتوى فقط
formatOnlyBooleanيشير ذلك إلى ما إذا كان سيتم محو التنسيق فقط، مع العِلم أنّ محو التنسيق يؤدي أيضًا إلى محو قواعد التحقّق من صحة البيانات.
validationsOnlyBooleanيحدد هذا الخيار ما إذا كنت تريد محو قواعد التحقّق من صحة البيانات فقط.
skipFilteredRowsBooleanما إذا كان يجب تجنُّب محو الصفوف التي تمت فلترتها

الإرجاع

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

المعلمات

الاسمالنوعالوصف
checkedValueObjectالقيمة المحدّدة لعملية التحقّق من صحة بيانات مربّع الاختيار.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
checkedValueObjectالقيمة المحدّدة لعملية التحقّق من صحة بيانات مربّع الاختيار.
uncheckedValueObjectالقيمة غير المحدّدة للتحقّق من بيانات مربّع الاختيار.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
colorStringرمز لون الخلفية بترميز 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);

المعلمات

الاسمالنوعالوصف
redIntegerقيمة اللون الأحمر بترميز RGB
greenIntegerالقيمة الخضراء في تنسيق RGB
blueIntegerقيمة اللون الأزرق بترميز 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);

المعلمات

الاسمالنوعالوصف
topBooleantrue للحدود، false لأي حدود، null بدون تغيير.
leftBooleantrue للحدود، false لأي حدود، null بدون تغيير.
bottomBooleantrue للحدود، false لأي حدود، null بدون تغيير.
rightBooleantrue للحدود، false لأي حدود، null بدون تغيير.
verticalBooleantrue للحدود العمودية الداخلية، false لعدم وجود حدود، null لعدم إجراء أي تغيير.
horizontalBooleantrue للحدود الأفقية الداخلية، 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,
);

المعلمات

الاسمالنوعالوصف
topBooleantrue للحدود، false لأي حدود، null بدون تغيير.
leftBooleantrue للحدود، false لأي حدود، null بدون تغيير.
bottomBooleantrue للحدود، false لأي حدود، null بدون تغيير.
rightBooleantrue للحدود، false لأي حدود، null بدون تغيير.
verticalBooleantrue للحدود العمودية الداخلية، false لعدم وجود حدود، null لعدم إجراء أي تغيير.
horizontalBooleantrue للحدود الأفقية الداخلية، false لعدم وجود حدود، null لعدم إجراء أي تغيير.
colorStringلون الحدود بترميز CSS مثل '#ffffff' أو 'white' أو null للون التلقائي (أسود)
styleBorderStyleنمط الحدود، 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');

المعلمات

الاسمالنوعالوصف
colorStringلون الخط في أسلوب 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');

المعلمات

الاسمالنوعالوصف
fontFamilyStringمجموعة الخطوط المطلوب ضبطها. تؤدي القيمة 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');

المعلمات

الاسمالنوعالوصف
fontLineStringنمط خطّ الخط، إما '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);

المعلمات

الاسمالنوعالوصف
sizeIntegerحجم نقطة الخط

الإرجاع

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

المعلمات

الاسمالنوعالوصف
fontStyleStringنمط الخط، إما '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');

المعلمات

الاسمالنوعالوصف
fontWeightStringكثافة الخط، إما '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)');

المعلمات

الاسمالنوعالوصف
formulaStringسلسلة تمثل الصيغة المطلوب ضبطها

الإرجاع

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])');

المعلمات

الاسمالنوعالوصف
formulaStringصيغة سلسلة.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
alignmentStringالاتّجاه، إما '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');

المعلمات

الاسمالنوعالوصف
noteStringنص الملاحظة المطلوب ضبطه. تؤدي القيمة 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');

المعلمات

الاسمالنوعالوصف
numberFormatStringسلسلة تنسيق رقم

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الاسمالنوعالوصف
showHyperlinkBooleanما إذا كان سيتم عرض الرابط التشعّبي أم لا

الإرجاع

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

المعلمات

الاسمالنوعالوصف
directionTextDirectionاتجاه النص المطلوب، إذا كان 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);

المعلمات

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

الإرجاع

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

المعلمات

الاسمالنوعالوصف
valueObjectقيمة النطاق

الإرجاع

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

المعلمات

الاسمالنوعالوصف
alignmentStringالاتّجاه، إما '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);

المعلمات

الاسمالنوعالوصف
isVerticalBooleanما إذا كان سيتم تجميع النص أم لا

الإرجاع

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

المعلمات

الاسمالنوعالوصف
isWrapEnabledBooleanما إذا كان سيتم لف النص أم لا

الإرجاع

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

المعلمات

الاسمالنوعالوصف
strategyWrapStrategyاستراتيجية الالتفاف المطلوبة

الإرجاع

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

انظر أيضًا

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