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تمثّل هذه السمة قيمة اللون الأزرق في نظام الترميز أحمر أخضر أزرق.

الإرجاع

‫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