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	لضبط الخلفية على لون RGB المحدّد.
setBorder(top, left, bottom, right, vertical, horizontal)	RangeList	تضبط خاصية الحد لكل Range في قائمة النطاقات.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	RangeList	تضبط خاصية الحدود باللون و/أو النمط لكل Range في قائمة النطاقات.
setFontColor(color)	RangeList	تضبط لون الخط لكل Range في قائمة النطاقات.
setFontFamily(fontFamily)	RangeList	تضبط مجموعة الخطوط لكل Range في قائمة النطاقات.
setFontLine(fontLine)	RangeList	تضبط نمط خط الخط لكل Range في قائمة النطاقات.
setFontSize(size)	RangeList	تضبط حجم الخط (بالنقاط) لكل Range في قائمة النطاقات.
setFontStyle(fontStyle)	RangeList	اضبط نمط الخط لكل Range في قائمة النطاقات.
setFontWeight(fontWeight)	RangeList	اضبط سُمك الخط لكل Range في قائمة النطاقات.
setFormula(formula)	RangeList	تعمل هذه السياسة على تعديل الصيغة لكل Range في قائمة النطاقات.
setFormulaR1C1(formula)	RangeList	تعمل هذه السياسة على تعديل الصيغة لكل Range في قائمة النطاقات.
setHorizontalAlignment(alignment)	RangeList	يمكنك ضبط المحاذاة الأفقية لكل Range في قائمة النطاقات.
setNote(note)	RangeList	لضبط نص الملاحظة لكل Range في قائمة النطاقات.
setNumberFormat(numberFormat)	RangeList	تضبط هذه السياسة تنسيق الأرقام أو التاريخ لكل Range في قائمة النطاقات.
setShowHyperlink(showHyperlink)	RangeList	لضبط ما إذا كان يجب عرض روابط تشعّبية لكل Range في قائمة النطاق أم لا.
setTextDirection(direction)	RangeList	لضبط اتجاه النص للخلايا في كل Range في قائمة النطاقات.
setTextRotation(degrees)	RangeList	لضبط إعدادات تدوير النص للخلايا في كل Range في قائمة النطاقات.
setValue(value)	RangeList	تحدد قيمة كل Range في قائمة النطاقات.
setVerticalAlignment(alignment)	RangeList	اضبط المحاذاة العمودية لكل Range في قائمة النطاقات.
setVerticalText(isVertical)	RangeList	لتحديد ما إذا كان سيتم تكديس النص للخلايا لكل Range في النطاق أم لا الحالية.
setWrap(isWrapEnabled)	RangeList	ضبط التفاف النص لكل Range في قائمة النطاقات.
setWrapStrategy(strategy)	RangeList	يتم ضبط استراتيجية التفاف النص لكل Range في قائمة النطاقات.
trimWhitespace()	RangeList	يزيل المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في قائمة النطاقات هذه.
uncheck()	RangeList	تغيير حالة مربعات الاختيار في النطاق إلى "غير محددة".

الوثائق التفصيلية

activate()

يؤدي هذا الإجراء إلى اختيار قائمة مثيلات عددها Range. تم ضبط النطاق الأخير في القائمة على أنّه active range.

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

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

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

الإرجاع

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

التفويض

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

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

---

breakApart()

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

يعادل استدعاء هذه الدالة في قائمة نطاق تحديد مجموعة من النطاقات تحديد التنسيق > دمج > إلغاء دمج عنصر القائمة في "جداول بيانات 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});

المعلمات

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

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

الاسم	النوع	الوصف
commentsOnly	Boolean	تحديد ما إذا كان سيتم محو التعليقات فقط
contentsOnly	Boolean	ما إذا كان سيتم محو المحتوى فقط أم لا.
formatOnly	Boolean	ما إذا كنت تريد محو التنسيق فقط أم لا لاحظ أن محو أيضًا على مسح قواعد التحقق من صحة البيانات.
validationsOnly	Boolean	ما إذا كان سيتم محو قواعد التحقق من صحة البيانات فقط.
skipFilteredRows	Boolean	ما إذا كان سيتم تجنُّب محو الصفوف التي تمت فلترتها.

الإرجاع

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

التفويض

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

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

---

clearContent()

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

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

المعلمات

الاسم	النوع	الوصف
checkedValue	Object	القيمة التي تم وضع علامة عليها للتحقّق من صحة بيانات مربّع الاختيار.

الإرجاع

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

التفويض

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

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

---

insertCheckboxes(checkedValue, uncheckedValue)

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

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

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

المعلمات

الاسم	النوع	الوصف
checkedValue	Object	القيمة التي تم وضع علامة عليها للتحقّق من صحة بيانات مربّع الاختيار.
uncheckedValue	Object	القيمة غير المحددة للتحقق من صحة بيانات مربع الاختيار.

الإرجاع

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

التفويض

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

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

---

removeCheckboxes()

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

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

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

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

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

الإرجاع

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

التفويض

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

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

---

setBackground(color)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setBackgroundRGB(red, green, blue)

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

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

المعلمات

الاسم	النوع	الوصف
red	Integer	القيمة الحمراء في تدوين النموذج اللوني أحمر أخضر أزرق.
green	Integer	القيمة الخضراء في تدوين النموذج اللوني أحمر أخضر أزرق.
blue	Integer	القيمة الزرقاء في تدوين النموذج اللوني أحمر أخضر أزرق.

الإرجاع

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

التفويض

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal)

تضبط خاصية الحد لكل Range في قائمة النطاقات. القيم الصالحة هي true (تفعيل) وfalse (إيقاف) وnull (بدون تغيير).

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

المعلمات

الاسم	النوع	الوصف
top	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
left	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
bottom	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
right	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
vertical	Boolean	true للحدود العمودية الداخلية، وfalse للحدود الرأسية الداخلية، وnull للخيار "بدون تغيير".
horizontal	Boolean	true للحدود الأفقية الداخلية، وfalse للحدود الأفقية، وnull للحدود بدون تغيير.

الإرجاع

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

التفويض

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

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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

تضبط خاصية الحدود باللون و/أو النمط لكل Range في قائمة النطاقات. القيم الصالحة هي true (تفعيل) وfalse (إيقاف) وnull (بدون تغيير). اللون هو ويتم تمثيلها في تدوين CSS؛ على سبيل المثال، '#ffffff' أو 'white'.

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

المعلمات

الاسم	النوع	الوصف
top	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
left	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
bottom	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
right	Boolean	true للحدود، وfalse للخيار "بدون"، وnull للإشارة إلى عدم التغيير.
vertical	Boolean	true للحدود العمودية الداخلية، وfalse للحدود الرأسية الداخلية، وnull للخيار "بدون تغيير".
horizontal	Boolean	true للحدود الأفقية الداخلية، وfalse للحدود الأفقية، وnull للحدود بدون تغيير.
color	String	لون الحدود في ترميز CSS مثل '#ffffff' أو 'white'، وnull للون التلقائي (أسود).
style	BorderStyle	نمط الحدود، وهو null للنمط التلقائي (متين).

الإرجاع

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

التفويض

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

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

---

setFontColor(color)

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

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

المعلمات

الاسم	النوع	الوصف
color	String	لون الخط في ترميز CSS مثل '#ffffff' أو 'white' CANNOT TRANSLATE تؤدي قيمة 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');

المعلمات

الاسم	النوع	الوصف
fontFamily	String	عائلة الخطوط التي يجب تعيينها؛ تؤدي قيمة null إلى إعادة ضبط مجموعة الخطوط.

الإرجاع

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

التفويض

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

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

---

setFontLine(fontLine)

تضبط نمط خط الخط لكل Range في قائمة النطاقات. خيارات أنماط الخطوط 'underline' أو 'line-through' أو 'none'

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

المعلمات

الاسم	النوع	الوصف
fontLine	String	يجب استخدام نمط خط الخط، إما 'underline' أو 'line-through' أو 'none'؛ وتعيد القيمة null تعيين نمط خط الخط.

الإرجاع

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

التفويض

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

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

---

setFontSize(size)

تضبط حجم الخط (بالنقاط) لكل Range في قائمة النطاقات.

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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setFontStyle(fontStyle)

اضبط نمط الخط لكل Range في قائمة النطاقات. خيارات نمط الخط هي 'italic' أو 'normal'

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

المعلمات

الاسم	النوع	الوصف
fontStyle	String	نمط الخط، إما 'italic' أو 'normal'؛ null على إعادة تعيين نمط الخط.

الإرجاع

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

التفويض

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

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

---

setFontWeight(fontWeight)

اضبط سُمك الخط لكل Range في قائمة النطاقات. خيارات عرض الخط هي 'normal' أو 'bold'

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

المعلمات

الاسم	النوع	الوصف
fontWeight	String	عرض الخط، إما 'bold' أو 'normal' null على إعادة تعيين عرض الخط.

الإرجاع

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

التفويض

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

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

---

setFormula(formula)

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

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

المعلمات

الاسم	النوع	الوصف
formula	String	سلسلة تمثِّل الصيغة المطلوب ضبطها.

الإرجاع

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

التفويض

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

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

---

setFormulaR1C1(formula)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setHorizontalAlignment(alignment)

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

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

المعلمات

الاسم	النوع	الوصف
alignment	String	المحاذاة، إما 'left' أو 'center' أو 'normal'؛ CANNOT TRANSLATE تؤدي القيمة 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');

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setNumberFormat(numberFormat)

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

يتم توضيح أنماط التنسيق المقبولة في دليل تنسيق التاريخ والأرقام في Sheets API.

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

المعلمات

الاسم	النوع	الوصف
numberFormat	String	سلسلة تنسيق الأرقام

الإرجاع

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

التفويض

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

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

---

setShowHyperlink(showHyperlink)

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

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

المعلمات

الاسم	النوع	الوصف
showHyperlink	Boolean	لتحديد ما إذا كان سيتم عرض الرابط التشعبي أم لا.

الإرجاع

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

التفويض

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

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

---

setTextDirection(direction)

لضبط اتجاه النص للخلايا في كل Range في قائمة النطاقات. إذا الاتجاه المحدد هو null، فسيتم استنتاج الاتجاه ثم ضبطه.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

المعلمات

الاسم	النوع	الوصف
direction	TextDirection	اتجاه النص المطلوب؛ إذا تم استنتاج الاتجاه null قبل الإعداد.

الإرجاع

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

التفويض

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

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

---

setTextRotation(degrees)

لضبط إعدادات تدوير النص للخلايا في كل Range في قائمة النطاقات. تشير رسالة الأشكال البيانية الإدخال مع الزاوية بين اتجاه النص القياسي والاتجاه المطلوب توجهك. يشير الإدخال صفر إلى أنه تم تعيين النص على الاتجاه القياسي.

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

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setValue(value)

تحدد قيمة كل Range في قائمة النطاقات. يمكن أن تكون القيمة رقمية أو سلسلة منطقية أو تاريخ. إذا كانت تبدأ بـ '=' يتم تفسيره على أنه معادلة.

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

المعلمات

الاسم	النوع	الوصف
value	Object	قيمة النطاق.

الإرجاع

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

التفويض

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

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

---

setVerticalAlignment(alignment)

اضبط المحاذاة العمودية لكل Range في قائمة النطاقات. خيارات المحاذاة هي 'top' أو 'middle' أو 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

المعلمات

الاسم	النوع	الوصف
alignment	String	المحاذاة، إما 'top' أو 'middle' أو 'bottom'؛ CANNOT TRANSLATE تؤدي القيمة 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);

المعلمات

الاسم	النوع	الوصف
isVertical	Boolean	تحديد ما إذا كان سيتم تكديس النص أم لا.

الإرجاع

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

التفويض

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

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

---

setWrap(isWrapEnabled)

ضبط التفاف النص لكل Range في قائمة النطاقات. تغيير حجم الخلايا التي تم تفعيل الالتفاف بها لعرض محتواها بالكامل. يتم عرض الخلايا التي تم إيقاف التفافها قدر الإمكان في الخلية. بدون تغيير الحجم أو التشغيل إلى عدة أسطر.

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

المعلمات

الاسم	النوع	الوصف
isWrapEnabled	Boolean	ما إذا كان سيتم التفاف النص أم لا.

الإرجاع

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

التفويض

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

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

---

setWrapStrategy(strategy)

يتم ضبط استراتيجية التفاف النص لكل Range في قائمة النطاقات.

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

المعلمات

الاسم	النوع	الوصف
strategy	WrapStrategy	استراتيجية التغليف المطلوبة.

الإرجاع

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

التفويض

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

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

---

trimWhitespace()

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• Range.trimWhitespace()

---

uncheck()

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

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

الإرجاع

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

التفويض

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

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