Class RangeList

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
RangeList

مجموعة من مثيلات Range أو أكثر في جدول البيانات نفسه. يمكنك استخدام هذه الفئة لتطبيق العمليات على مجموعات من الخلايا أو النطاقات غير المجاورة.

الطُرق

الطريقةنوع الإرجاعوصف قصير
activate()RangeListاختيار قائمة مثيلات Range.
breakApart()RangeListقسِّم كل الخلايا التي تم دمجها أفقيًا أو عموديًا ضمن قائمة النطاقات إلى خلايا فردية مرة أخرى.
check()RangeListتُغيِّر حالة مربّعات الاختيار في النطاق إلى "تم وضع علامة عليه".
clear()RangeListيؤدي إلى محو نطاق المحتوى والتنسيقات وقواعد التحقق من البيانات لكل Range في قائمة النطاقات.
clear(options)RangeListيؤدي إلى محو نطاق المحتوى والتنسيق وقواعد التحقّق من صحة البيانات والتعليقات على النحو المحدّد في الخيارات المحدّدة.
clearContent()RangeListيؤدي إلى محو محتوى كل Range في قائمة النطاقات، مع ترك التنسيق كما هو.
clearDataValidations()RangeListمحو قواعد التحقّق من صحة البيانات لكل Range في قائمة النطاقات.
clearFormat()RangeListمحو تنسيق النص لكل Range في قائمة النطاقات.
clearNote()RangeListمحو الملاحظة لكل Range في قائمة النطاقات.
getRanges()Range[]لعرض قائمة لمثيل واحد أو أكثر من النوع Range في ورقة البيانات نفسها.
insertCheckboxes()RangeListإدراج مربّعات اختيار في كل خلية في النطاق، وضبطها على true لتحديدها وfalse لإلغاء اختيارها.
insertCheckboxes(checkedValue)RangeListإدراج مربّعات اختيار في كل خلية في النطاق، مع ضبط قيمة مخصّصة للمربّع المحدد والسلسلة الفارغة لإلغاء الاختيار.
insertCheckboxes(checkedValue, uncheckedValue)RangeListإدراج مربّعات اختيار في كل خلية في النطاق، حيث تم ضبطها باستخدام قيم مخصّصة للحالات المحدّدة وغير المحدّدة.
removeCheckboxes()RangeListإزالة جميع مربّعات الاختيار من النطاق.
setBackground(color)RangeListتعمل هذه السياسة على ضبط لون الخلفية لكل Range في قائمة النطاقات.
setBackgroundRGB(red, green, blue)RangeListلضبط الخلفية على لون نموذج أحمر أخضر أزرق محدد.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListتعمل هذه السياسة على ضبط موقع الحدود لكل Range في قائمة النطاقات.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListتعمل هذه السياسة على ضبط موقع الحدود باستخدام لون و/أو نمط لكل Range في قائمة النطاقات.
setFontColor(color)RangeListتعمل على ضبط لون الخط لكل Range في قائمة النطاقات.
setFontFamily(fontFamily)RangeListتعمل هذه السياسة على ضبط مجموعة الخطوط لكل Range في قائمة النطاقات.
setFontLine(fontLine)RangeListتضبط هذه السياسة نمط خط الخط لكل Range في قائمة النطاقات.
setFontSize(size)RangeListتضبط هذه السياسة حجم الخط (بالنقاط) لكل Range في قائمة النطاقات.
setFontStyle(fontStyle)RangeListيمكنك ضبط نمط الخط لكل Range في قائمة النطاقات.
setFontWeight(fontWeight)RangeListيمكنك ضبط حجم الخط لكل Range في قائمة النطاقات.
setFormula(formula)RangeListيتم تعديل صيغة كل Range في قائمة النطاقات.
setFormulaR1C1(formula)RangeListيتم تعديل صيغة كل Range في قائمة النطاقات.
setHorizontalAlignment(alignment)RangeListيمكنك ضبط المحاذاة الأفقية لكل Range في قائمة النطاقات.
setNote(note)RangeListضبط نص الملاحظة لكل Range في قائمة النطاقات
setNumberFormat(numberFormat)RangeListتعمل على ضبط الرقم أو تنسيق التاريخ لكل Range في قائمة النطاقات.
setShowHyperlink(showHyperlink)RangeListلتحديد ما إذا كان يجب عرض الروابط التشعّبية لكل Range في قائمة النطاقات أم لا.
setTextDirection(direction)RangeListلضبط اتجاه النص للخلايا في كل Range في قائمة النطاقات.
setTextRotation(degrees)RangeListلضبط إعدادات تدوير النص للخلايا في كل Range في قائمة النطاقات.
setValue(value)RangeListيحدِّد هذا الإعداد قيمة كل Range في قائمة النطاقات.
setVerticalAlignment(alignment)RangeListيمكنك ضبط المحاذاة العمودية لكل Range في قائمة النطاقات.
setVerticalText(isVertical)RangeListلتحديد ما إذا كان سيتم تكديس نص الخلايا عن كل Range في قائمة النطاق.
setWrap(isWrapEnabled)RangeListيمكنك ضبط التفاف النص لكل Range في قائمة النطاقات.
setWrapStrategy(strategy)RangeListتعمل هذه السياسة على ضبط استراتيجية التفاف النص لكل Range في قائمة النطاقات.
trimWhitespace()RangeListلقطع المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في قائمة النطاق هذه.
uncheck()RangeListتُغيِّر حالة مربّعات الاختيار في النطاق إلى "غير محدّد".

المستندات التفصيلية

activate()

اختيار قائمة مثيلات Range. تم ضبط النطاق الأخير في القائمة على أنه active range.

ملاحظة: يقدّم ذلك طريقة لتحديد عدة نطاقات في عدة نطاقات.

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

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

تذكرة ذهاب وعودة

RangeList — قائمة بالنطاقات النشطة للسلاسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

breakApart()

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

إن استدعاء هذه الدالة في قائمة نطاقات يعادل اختيار مجموعة من النطاقات واختيار عنصر القائمة Format > Merge > Unmerge (جداول بيانات Google).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

check()

تعمل على تغيير حالة مربعات الاختيار في النطاق إلى "تم تحديدها". وتتجاهل الخلايا في النطاق التي لا تحتوي حاليًا على القيمة المحددة أو التي لم يتم التحقق منها.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'checked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clear()

يؤدي إلى محو نطاق المحتوى والتنسيقات وقواعد التحقق من البيانات لكل Range في قائمة النطاقات.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clear(options)

يؤدي إلى محو نطاق المحتوى والتنسيق وقواعد التحقّق من صحة البيانات والتعليقات على النحو المحدّد في الخيارات المحدّدة. يتم محو جميع البيانات تلقائيًا.

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

المعلّمات

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

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

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

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clearContent()

يؤدي إلى محو محتوى كل Range في قائمة النطاقات، مع ترك التنسيق كما هو.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clearDataValidations()

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clearFormat()

محو تنسيق النص لكل Range في قائمة النطاقات.

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

clearNote()

محو الملاحظة لكل Range في قائمة النطاقات.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

getRanges()

لعرض قائمة لمثيل واحد أو أكثر من النوع Range في ورقة البيانات نفسها.

تذكرة ذهاب وعودة

Range[] — قائمة النطاقات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

insertCheckboxes()

إدراج مربّعات اختيار في كل خلية في النطاق، وضبطها على true لتحديدها وfalse لإلغاء اختيارها. لضبط قيمة جميع الخلايا في النطاق على false.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

insertCheckboxes(checkedValue)

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

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

المعلّمات

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

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

insertCheckboxes(checkedValue, uncheckedValue)

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

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

المعلّمات

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

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

removeCheckboxes()

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

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

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

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setBackground(color)

تعمل هذه السياسة على ضبط لون الخلفية لكل Range في قائمة النطاقات. ويتم تمثيل اللون في تدوين CSS، على سبيل المثال، '#ffffff' أو 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

المعلّمات

الاسمالنوعالوصف
colorStringرمز لون الخلفية في تدوين CSS مثل '#ffffff' أو 'white'، وتعمل قيمة null على إعادة ضبط اللون.

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setBackgroundRGB(red, green, blue)

لضبط الخلفية على لون نموذج أحمر أخضر أزرق محدد. هذا برنامج تضمين ملائم حول مكالمة setBackground(color).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

المعلّمات

الاسمالنوعالوصف
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 (بدون تغيير).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

المعلّمات

الاسمالنوعالوصف
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'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

المعلّمات

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

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

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

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

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

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

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

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

المعلّمات

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

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setHorizontalAlignment(alignment)

يمكنك ضبط المحاذاة الأفقية لكل Range في قائمة النطاقات. خيارات المحاذاة هي 'left' أو 'center' أو 'right'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment("center");

المعلّمات

الاسمالنوعالوصف
alignmentStringالمحاذاة، سواء 'left' أو 'center' أو 'normal'، القيمة null تعيد ضبط المحاذاة.

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setNote(note)

ضبط نص الملاحظة لكل Range في قائمة النطاقات

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

المعلّمات

الاسمالنوعالوصف
noteStringنص الملاحظة المطلوب إعداده، تؤدي قيمة null إلى إزالة الملاحظة.

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setNumberFormat(numberFormat)

تعمل على ضبط الرقم أو تنسيق التاريخ لكل Range في قائمة النطاقات.

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

المعلّمات

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

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

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

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

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

المعلّمات

الاسمالنوعالوصف
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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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()

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

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

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

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

راجع أيضًا


uncheck()

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

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

تذكرة ذهاب وعودة

RangeList — قائمة النطاقات هذه، لسلسلة تسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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