مجموعة من مثيل 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()
قسِّم جميع الخلايا المدمجة أفقيًا أو عموديًا والواردة في قائمة النطاق إلى خلايا فردية مرة أخرى.
يعادل استدعاء هذه الدالة في قائمة نطاقات تحديد مجموعة من النطاقات وتحديد عنصر القائمة تنسيق > دمج > إلغاء دمج جداول البيانات.
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});
المَعلمات
الاسم | Type | الوصف |
---|---|---|
options | Object | كائن JavaScript يحدد المعلَمات المتقدمة، كما هو موضّح أدناه. |
المعلمات المتقدمة
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
color | String | لون الخط في ترميز CSS، مثل '#ffffff' أو 'white' ،
وتشير القيمة null إلى إعادة ضبط اللون. |
استرجاع الكرة
RangeList
- قائمة النطاقات هذه، للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
لضبط مجموعة الخطوط لكل Range
في قائمة النطاق يتم وصف مجموعة الخطوط بمعرّف سلسلة مثل Arial
أو Roboto
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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])');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
alignment | String | تمت إعادة ضبط المحاذاة، إما '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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
note | String | نص الملاحظة المطلوب تحديده، ستؤدي قيمة 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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
alignment | String | تمت إعادة ضبط المحاذاة، إما 'top' أو 'middle' أو 'bottom' ، كما أنّ القيمة null تؤدي إلى إعادة ضبط المحاذاة. |
استرجاع الكرة
RangeList
- قائمة النطاقات هذه، للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalText(isVertical)
تحدّد ما إذا كان سيتم تكديس النص للخلايا لكل Range
في قائمة النطاق أم لا. في حال تكديس النص عموديًا، يتم تجاهل إعداد تدوير النص بالدرجة.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
يمكن أيضًا مراجعة
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