Class Range

النطاق

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
activate()Rangeلضبط النطاق المحدّد على أنه active range، مع الخلية اليسرى في النطاق كـ current cell.
activateAsCurrentCell()Rangeلضبط الخلية المحدّدة على أنها current cell.
addDeveloperMetadata(key)Rangeلإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى النطاق.
addDeveloperMetadata(key, visibility)Rangeلإضافة بيانات وصفية لمطوّر البرامج مع المفتاح المحدد ومستوى الرؤية إلى النطاق.
addDeveloperMetadata(key, value)Rangeلإضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدد والقيمة إلى النطاق
addDeveloperMetadata(key, value, visibility)Rangeلإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة وإمكانية الوصول إلى النطاق المحدد.
applyColumnBanding()Bandingيتم تطبيق مظهر ربط الأعمدة التلقائي على النطاق.
applyColumnBanding(bandingTheme)Bandingيتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق.
applyColumnBanding(bandingTheme, showHeader, showFooter)Bandingيتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق من خلال إعدادات العنوان والتذييل المحدّدة.
applyRowBanding()Bandingتطبيق مظهر ربط الصف التلقائي على النطاق
applyRowBanding(bandingTheme)Bandingتطبيق مظهر ربط صف محدد على النطاق.
applyRowBanding(bandingTheme, showHeader, showFooter)Bandingيتم تطبيق مظهر تباين الصفوف المحدّد على النطاق مع ضبط الرؤوس والتذييلات المحدّدة.
autoFill(destination, series)voidتملأ destinationRange بالبيانات استنادًا إلى البيانات في هذا النطاق.
autoFillToNeighbor(series)voidتحسب نطاقًا لتعبئة البيانات الجديدة بناءً على الخلايا المجاورة وملء هذا النطاق تلقائيًا بقيم جديدة استنادًا إلى البيانات المضمّنة في هذا النطاق.
breakApart()Rangeقسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.
canEdit()Booleanتحديد ما إذا كان لدى المستخدم الإذن لتعديل كل خلية في النطاق.
check()Rangeتغيير حالة مربّعات الاختيار في النطاق إلى "تم وضع علامة في المربّع".
clear()Rangeمحو نطاق المحتوى والتنسيقات
clear(options)Rangeيؤدي إلى محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقّق من صحة البيانات و/أو التعليقات، كما هو محدّد بالخيارات المتقدّمة المحددة.
clearContent()Rangeيمحو محتوى النطاق، مع ترك التنسيق بدون تغيير.
clearDataValidations()Rangeمحو قواعد التحقّق من صحة البيانات للنطاق
clearFormat()Rangeمحو التنسيق لهذا النطاق
clearNote()Rangeيؤدي إلى محو الملاحظة في الخلية أو الخلايا المحددة.
collapseGroups()Rangeتصغير جميع المجموعات المضمّنة بالكامل ضمن النطاق
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidانسخ تنسيق النطاق إلى الموقع الجغرافي المحدّد.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidانسخ تنسيق النطاق إلى الموقع الجغرافي المحدّد.
copyTo(destination)voidنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا
copyTo(destination, copyPasteType, transposed)voidنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا
copyTo(destination, options)voidنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidانسخ محتوى النطاق إلى الموقع المحدّد.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidانسخ محتوى النطاق إلى الموقع المحدّد.
createDataSourcePivotTable(dataSource)DataSourcePivotTableينشئ جدولاً محوريًا لمصدر بيانات فارغًا من مصدر البيانات، ويكون مرتبطًا بالخلية الأولى في هذا النطاق.
createDataSourceTable(dataSource)DataSourceTableينشئ جدولاً فارغًا لمصدر البيانات من مصدر البيانات، ثابتًا في الخلية الأولى في هذا النطاق.
createDeveloperMetadataFinder()DeveloperMetadataFinderتعرض قيمة وصفية البيانات الوصفية لمطوّر البرامج للعثور على البيانات الوصفية لمطوّر البرامج داخل نطاق هذا النطاق.
createFilter()Filterتنشئ فلترًا ويطبّقه على النطاق المحدّد في ورقة البيانات.
createPivotTable(sourceData)PivotTableتنشئ هذه السياسة جدولاً محوريًا فارغًا من sourceData المحدّد الذي تم إرساؤه في الخلية الأولى في هذا النطاق.
createTextFinder(findText)TextFinderتنشئ هذه الميزة نصًا للبحث عن النطاق، ويمكنها العثور على النص واستبداله في هذا النطاق.
deleteCells(shiftDimension)voidحذف هذا النطاق من الخلايا.
expandGroups()Rangeيؤدي هذا الخيار إلى توسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكّم فيها مع هذا النطاق.
getA1Notation()Stringلعرض وصف سلسلة للنطاق، بتدوين A1.
getBackground()Stringتعرض لون خلفية الخلية العلوية اليسرى في النطاق (مثلاً، '#ffffff').
getBackgroundObject()Colorلعرض لون خلفية الخلية العلوية اليسرى في النطاق.
getBackgroundObjects()Color[][]لعرض ألوان خلفية الخلايا في النطاق.
getBackgrounds()String[][]تعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff').
getBandings()Banding[]تعرض جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق.
getCell(row, column)Rangeلعرض خلية معيّنة ضمن نطاق.
getColumn()Integerعرض موضع عمود البدء لهذا النطاق.
getDataRegion()Rangeتعرض نسخة من النطاق الموسّع في العناصر الأساسية Direction الرئيسية لتغطية جميع الخلايا المجاورة التي تحتوي على بيانات.
getDataRegion(dimension)Rangeتعرض نسخة من النطاق الموسّع Direction.UP وDirection.DOWN إذا كانت السمة المحدّدة هي Dimension.ROWS، أو Direction.NEXT وDirection.PREVIOUS إذا كانت السمة Dimension.COLUMNS.
getDataSourceFormula()DataSourceFormulaتعرض DataSourceFormula للخلية الأولى في النطاق، أو null إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات.
getDataSourceFormulas()DataSourceFormula[]تعرض DataSourceFormula للخلايا في النطاق.
getDataSourcePivotTables()DataSourcePivotTable[]الحصول على جميع الجداول المحورية لمصدر البيانات التي تتداخل مع النطاق
getDataSourceTables()DataSourceTable[]للحصول على جميع جداول مصادر البيانات التي تتقاطع مع النطاق.
getDataSourceUrl()Stringعرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء الرسوم البيانية وطلبات البحث.
getDataTable()DataTableاعرض البيانات داخل هذا الكائن كجدول بيانات.
getDataTable(firstRowIsHeader)DataTableويمكنك عرض البيانات داخل هذا النطاق كجدول بيانات.
getDataValidation()DataValidationتعرض قاعدة التحقق من صحة البيانات للخلية أعلى اليمين في النطاق.
getDataValidations()DataValidation[][]تعرض قواعد التحقّق من صحة البيانات لجميع الخلايا في النطاق.
getDeveloperMetadata()DeveloperMetadata[]الحصول على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق
getDisplayValue()Stringتعرض القيمة المعروضة للخلية أعلى اليمين في النطاق.
getDisplayValues()String[][]لعرض شبكة القيم المستطيلة لهذا النطاق.
getFilter()Filterتعرض الفلتر في ورقة البيانات التي ينتمي إليها هذا النطاق، أو null في حال عدم توفّر فلتر في ورقة البيانات.
getFontColorObject()Colorلعرض لون خط الخلية في أعلى يمين النطاق.
getFontColorObjects()Color[][]تعرض ألوان الخط للخلايا في النطاق.
getFontFamilies()String[][]لعرض مجموعات الخطوط للخلايا في النطاق.
getFontFamily()Stringتعرض مجموعة الخطوط للخلية في أعلى يمين النطاق.
getFontLine()Stringيعرض نمط الخط للخلية في أعلى يمين النطاق ('underline' أو 'line-through' أو 'none').
getFontLines()String[][]للحصول على نمط الخط للخلايا في النطاق ('underline' أو 'line-through' أو 'none').
getFontSize()Integerلعرض حجم الخط بحجم النقطة للخلية في أعلى يمين النطاق.
getFontSizes()Integer[][]تعرض أحجام الخط للخلايا في النطاق.
getFontStyle()Stringلعرض نمط الخط ('italic' أو 'normal') للخلية في أعلى يمين النطاق.
getFontStyles()String[][]لعرض أنماط الخط للخلايا في النطاق.
getFontWeight()Stringلعرض وزن الخط (عادي/غامق) للخلية في أعلى يمين النطاق.
getFontWeights()String[][]لعرض أوزان الخط للخلايا في النطاق.
getFormula()Stringلعرض الصيغة (تدوين A1) للخلية أعلى يمين النطاق، أو سلسلة فارغة إذا كانت الخلية فارغة أو لا تحتوي على صيغة.
getFormulaR1C1()Stringتعرض الصيغة (تدوين R1C1) لخلية معينة، أو null إذا لم تكن موجودة.
getFormulas()String[][]لعرض الصيغ (تدوين A1) للخلايا في النطاق.
getFormulasR1C1()String[][]تعرض الصيغ (تدوين R1C1) للخلايا في النطاق.
getGridId()Integerتعرض رقم تعريف الشبكة لورقة البيانات الرئيسية للنطاق.
getHeight()Integerتعرض ارتفاع النطاق.
getHorizontalAlignment()Stringلعرض المحاذاة الأفقية للنص (يسار/وسم/يمين) للخلية في أعلى يمين النطاق.
getHorizontalAlignments()String[][]تعرض المحاذاة الأفقية للخلايا في النطاق.
getLastColumn()Integerلعرض موضع عمود النهاية.
getLastRow()Integerلعرض موضع صف النهاية.
getMergedRanges()Range[]تعرض صفيفًا من Range كائنات تمثّل خلايا مدمَجة تكون بالكامل داخل النطاق الحالي أو تحتوي على خلية واحدة على الأقل في النطاق الحالي.
getNextDataCell(direction)Rangeبدءًا من الخلية في العمود والصف الأول من النطاق، تعرض الخلية التالية في الاتجاه المحدّد الذي يمثل حافة نطاق متجاور من الخلايا يحتوي على بيانات داخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه.
getNote()Stringلعرض الملاحظة المرتبطة بالنطاق المحدد.
getNotes()String[][]لعرض الملاحظات المرتبطة بالخلايا في النطاق.
getNumColumns()Integerلعرض عدد الأعمدة في هذا النطاق.
getNumRows()Integerلعرض عدد الصفوف في هذا النطاق.
getNumberFormat()Stringالحصول على تنسيق الرقم أو التاريخ للخلية أعلى يمين النطاق المحدد.
getNumberFormats()String[][]لعرض تنسيقات التاريخ أو الأرقام للخلايا في النطاق.
getRichTextValue()RichTextValueتعرض قيمة النص المنسق للخلية أعلى يمين النطاق، أو null إذا لم تكن قيمة الخلية نصًا.
getRichTextValues()RichTextValue[][]تعرض قيم النص المنسّق للخلايا في النطاق.
getRow()Integerلعرض موضع الصف لهذا النطاق.
getRowIndex()Integerلعرض موضع الصف لهذا النطاق.
getSheet()Sheetتعرض ورقة البيانات التي ينتمي إليها هذا النطاق.
getTextDirection()TextDirectionلعرض اتجاه النص للخلية اليمنى العليا من النطاق.
getTextDirections()TextDirection[][]لعرض اتجاهات النص للخلايا في النطاق.
getTextRotation()TextRotationلعرض إعدادات تدوير النص للخلية اليمنى العليا من النطاق.
getTextRotations()TextRotation[][]لعرض إعدادات تدوير النص للخلايا في النطاق.
getTextStyle()TextStyleلعرض نمط النص للخلية العلوية اليمنى من النطاق.
getTextStyles()TextStyle[][]لعرض أنماط النص للخلايا في النطاق.
getValue()Objectلعرض قيمة الخلية في أعلى يمين النطاق.
getValues()Object[][]لعرض شبكة القيم المستطيلة لهذا النطاق.
getVerticalAlignment()Stringتعرض المحاذاة العمودية (أعلى/الوسط/الأسفل) للخلية في أعلى يمين النطاق.
getVerticalAlignments()String[][]تعرض المحاذاة العمودية للخلايا في النطاق.
getWidth()Integerلعرض عرض النطاق في الأعمدة.
getWrap()Booleanلعرض ما إذا كان النص في لفّة الخلية.
getWrapStrategies()WrapStrategy[][]لعرض استراتيجيات التفاف النص للخلايا في النطاق.
getWrapStrategy()WrapStrategyلعرض استراتيجية التفاف النص للخلية اليمنى العليا من النطاق.
getWraps()Boolean[][]لعرض ما إذا كان النص في التفاف الخلايا.
insertCells(shiftDimension)Rangeإدخال خلايا فارغة في هذا النطاق
insertCheckboxes()Rangeإدراج مربّعات اختيار في كل خلية في النطاق، مع ضبط true للمربّعات المحددة وfalse لإزالة العلامة منها.
insertCheckboxes(checkedValue)Rangeإدراج مربعات اختيار في كل خلية في النطاق، مع ضبط قيمة مخصّصة للمربّعات المحددة والسلسلة الفارغة لإزالة العلامة من المربّع.
insertCheckboxes(checkedValue, uncheckedValue)Rangeإدراج مربعات اختيار في كل خلية في النطاق، مع ضبط القيم المخصصة للحالات التي تم وضع علامة فيها وغير محدّدة.
isBlank()Booleanتعرض true إذا كان النطاق فارغًا تمامًا.
isChecked()Booleanلعرض ما إذا كانت جميع الخلايا في النطاق بالحالة "تم وضع علامة فيها" أم لا.
isEndColumnBounded()Booleanتحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن.
isEndRowBounded()Booleanتحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بصف معيّن.
isPartOfMerge()Booleanلعرض true إذا كانت الخلايا في النطاق الحالي تتداخل مع أي خلايا مدمجة.
isStartColumnBounded()Booleanتحدّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بعمود معيّن.
isStartRowBounded()Booleanتحدِّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بصف معيّن.
merge()Rangeتدمج الخلايا في النطاق معًا في وحدة واحدة.
mergeAcross()Rangeادمج الخلايا في النطاق في أعمدة النطاق.
mergeVertically()Rangeتدمج الخلايا في النطاق معًا.
moveTo(target)voidقص ولصق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق الهدف.
offset(rowOffset, columnOffset)Rangeتعرض نطاقًا جديدًا تتم إزالته من هذا النطاق من خلال عدد الصفوف والأعمدة المحدّد (الذي يمكن أن يكون سالبًا).
offset(rowOffset, columnOffset, numRows)Rangeتعرض نطاقًا جديدًا بالنسبة إلى النطاق الحالي، حيث تتم إزاحة النقطة العلوية اليسرى من النطاق الحالي بالصفوف والأعمدة المعيّنة، والارتفاع المحدد في الخلايا.
offset(rowOffset, columnOffset, numRows, numColumns)Rangeتعرض نطاقًا جديدًا بالنسبة إلى النطاق الحالي، حيث تتم إزاحة النقطة العلوية اليسرى من النطاق الحالي بالصفوف والأعمدة المعيّنة، بالارتفاع والعرض المحددَين في الخلايا.
protect()Protectionتنشئ عنصرًا يمكن أن يحمي النطاق من تعديله باستثناء المستخدمين الذين لديهم إذن.
randomize()Rangeالترتيب العشوائي للصفوف في النطاق المحدّد
removeCheckboxes()Rangeتزيل جميع مربّعات الاختيار من النطاق.
removeDuplicates()Rangeيزيل الصفوف ضمن هذا النطاق الذي يتضمن قيمًا مكررة للقيم في أي صف سابق.
removeDuplicates(columnsToCompare)Rangeتزيل صفوفًا ضمن هذا النطاق الذي يتضمن قيمًا من الأعمدة المحددة مكررة من القيم التي يمثلها أي صف سابق.
setBackground(color)Rangeلضبط لون خلفية جميع الخلايا في النطاق في تدوين CSS (مثل '#ffffff' أو 'white').
setBackgroundObject(color)Rangeضبط لون الخلفية لجميع الخلايا في النطاق
setBackgroundObjects(color)Rangeلضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق).
setBackgroundRGB(red, green, blue)Rangeلضبط الخلفية على اللون المعنيّ باستخدام قيم RGB (العدد الصحيح بين 0 و255 شاملاً).
setBackgrounds(color)Rangeلضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق).
setBorder(top, left, bottom, right, vertical, horizontal)Rangeضبط موقع الحدود
setBorder(top, left, bottom, right, vertical, horizontal, color, style)Rangeلضبط سمة الحدود مع اللون و/أو النمط.
setDataValidation(rule)Rangeلضبط قاعدة واحدة للتحقق من صحة البيانات لجميع الخلايا في النطاق.
setDataValidations(rules)Rangeضبط قواعد التحقق من البيانات لجميع الخلايا في النطاق.
setFontColor(color)Rangeلضبط لون الخط في تدوين CSS (مثل '#ffffff' أو 'white').
setFontColorObject(color)Rangeلضبط لون الخط للنطاق المحدّد.
setFontColorObjects(colors)Rangeتُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق).
setFontColors(colors)Rangeتُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق).
setFontFamilies(fontFamilies)Rangeتُستخدم شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setFontFamily(fontFamily)Rangeضبط مجموعة الخطوط، مثل "xxx" أو "Helvetica".
setFontLine(fontLine)Rangeلضبط نمط خط الخط للنطاق المحدَّد ('underline' أو 'line-through' أو 'none').
setFontLines(fontLines)Rangeتضبط شبكة مستطيلة بأنماط خطوط (يجب أن تتطابق مع سمات هذا النطاق).
setFontSize(size)Rangeلضبط حجم الخط، بحيث يكون الحجم بحجم النقطة المطلوب استخدامه
setFontSizes(sizes)Rangeلتحديد شبكة مستطيلة بأحجام خطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق).
setFontStyle(fontStyle)Rangeيمكنك ضبط نمط الخط للنطاق المحدَّد ('italic' أو 'normal').
setFontStyles(fontStyles)Rangeتُستخدم شبكة مستطيلة لأنماط الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setFontWeight(fontWeight)Rangeضبط كثافة الخط للنطاق المحدَّد (عادي/غامق)
setFontWeights(fontWeights)Rangeلإعداد شبكة مستطيلة بأوزان الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setFormula(formula)Rangeتُعدِّل الصيغة لهذا النطاق.
setFormulaR1C1(formula)Rangeتُعدِّل الصيغة لهذا النطاق.
setFormulas(formulas)Rangeتضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق).
setFormulasR1C1(formulas)Rangeتضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق).
setHorizontalAlignment(alignment)Rangeاضبط المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المحدَّد (يسارًا/وسطًا/يمينًا).
setHorizontalAlignments(alignments)Rangeتضبط شبكة مستطيلة للمحاذاة الأفقية.
setNote(note)Rangeلضبط الملاحظة على القيمة المحدّدة.
setNotes(notes)Rangeتُستخدم شبكة مستطيلة للملاحظات (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setNumberFormat(numberFormat)Rangeلضبط تنسيق الرقم أو التاريخ على سلسلة التنسيق المحددة.
setNumberFormats(numberFormats)Rangeتحدّد شبكة مستطيلة بتنسيقات الأرقام أو التواريخ (يجب أن تتطابق مع سمات هذا النطاق).
setRichTextValue(value)Rangeلضبط قيمة النص المنسق للخلايا في النطاق
setRichTextValues(values)Rangeتضبط شبكة مستطيلة من قيم النص المنسّق.
setShowHyperlink(showHyperlink)Rangeتحدد ما إذا كان يجب أن يعرض النطاق روابط تشعّبية أم لا.
setTextDirection(direction)Rangeلضبط اتجاه النص للخلايا في النطاق.
setTextDirections(directions)Rangeتُستخدم شبكة مستطيلة للاتجاهات النصية.
setTextRotation(degrees)Rangeلضبط إعدادات تدوير النص للخلايا في النطاق.
setTextRotation(rotation)Rangeلضبط إعدادات تدوير النص للخلايا في النطاق.
setTextRotations(rotations)Rangeتُستخدم شبكة مستطيلة لتدوير النصوص.
setTextStyle(style)Rangeلضبط نمط النص للخلايا في النطاق.
setTextStyles(styles)Rangeتضبط شبكة مستطيلة من أنماط النص.
setValue(value)Rangeتحدّد قيمة النطاق.
setValues(values)Rangeتُستخدم شبكة مستطيلة من القيم (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setVerticalAlignment(alignment)Rangeاضبط المحاذاة العمودية (من الأعلى إلى الأسفل) للنطاق المحدّد (من الأعلى/الوسط/الأسفل).
setVerticalAlignments(alignments)Rangeتُستخدم شبكة مستطيلة للمحاذاة العمودية (يجب أن تتطابق مع الأبعاد لهذا النطاق).
setVerticalText(isVertical)Rangeلتحديد ما إذا كان سيتم تكديس النص للخلايا في النطاق أم لا.
setWrap(isWrapEnabled)Rangeاضبط التفاف الخلية للنطاق المحدّد.
setWrapStrategies(strategies)Rangeتحدّد شبكة مستطيلة لاستراتيجيات الالتفاف.
setWrapStrategy(strategy)Rangeتضبط استراتيجية التفاف النص للخلايا في النطاق.
setWraps(isWrapEnabled)Rangeتحدِّد شبكة مستطيلة لسياسات التفاف الكلمات (يجب أن تتطابق مع سمات هذا النطاق).
shiftColumnGroupDepth(delta)Rangeتغيّر عمق تجميع الأعمدة للنطاق حسب القيمة المحددة.
shiftRowGroupDepth(delta)Rangeتغيّر عمق تجميع الصفوف للنطاق حسب المبلغ المحدّد.
sort(sortSpecObj)Rangeيتم ترتيب الخلايا في النطاق المحدّد حسب العمود والترتيب المحدّد.
splitTextToColumns()voidلتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى محدِّد تم اكتشافه تلقائيًا.
splitTextToColumns(delimiter)voidلتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحدَّدة كمُحدِّد مخصَّص.
splitTextToColumns(delimiter)voidلتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى المُحدِّد المحدد.
trimWhitespace()Rangeلقطع مسافة بيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في هذا النطاق.
uncheck()Rangeتغيير حالة مربّعات الاختيار في النطاق إلى "غير محدد".

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

activate()

لضبط النطاق المحدّد على أنه active range، مع الخلية اليسرى في النطاق كـ current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

رحلة العودة

Range: هذا النطاق للسلسلة.


activateAsCurrentCell()

لضبط الخلية المحدّدة على أنها current cell.

إذا كانت الخلية المحدّدة موجودة في نطاق حالي، سيصبح هذا النطاق هو النطاق النشط مع الخلية في الوقت الحالي.

إذا لم تكن الخلية المحددة موجودة في أي نطاق حالي، ستتم إزالة التحديد الحالي وتصبح الخلية الخلية الحالية والنطاق النشط.

ملاحظة: يجب أن تتألّف السمة Range المحدّدة من خلية واحدة، وإلا سيتم عرض استثناء.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

addDeveloperMetadata(key)

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

addDeveloperMetadata(key, visibility)

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
visibilityDeveloperMetadataVisibilityإذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

addDeveloperMetadata(key, value)

لإضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدد والقيمة إلى النطاق

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
valueStringقيمة البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

addDeveloperMetadata(key, value, visibility)

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

المَعلمات

الاسمالنوعالوصف
keyStringتمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج.
valueStringقيمة البيانات الوصفية الجديدة لمطوّر البرامج.
visibilityDeveloperMetadataVisibilityإذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

applyColumnBanding()

يتم تطبيق مظهر ربط الأعمدة التلقائي على النطاق. تتضمن عملية الربط تلقائيًا الرأس واللون بدون تذييل.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

applyColumnBanding(bandingTheme)

يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق. يكون السوار تلقائيًا لونًا مختلفًا بدون لون تذييل.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

المَعلمات

الاسمالنوعالوصف
bandingThemeBandingThemeمظهر اللون الذي سيتم تطبيقه على الأعمدة في النطاق

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق من خلال إعدادات العنوان والتذييل المحدّدة.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

المَعلمات

الاسمالنوعالوصف
bandingThemeBandingThemeمظهر اللون الذي سيتم تطبيقه على الأعمدة في النطاق
showHeaderBooleanوإذا تم ضبط true، يتم تطبيق لون عنوان التصنيف الشامل على العمود الأول.
showFooterBooleanإذا كانت القيمة true، يتم تطبيق لون تذييل مظهر التصنيف على العمود الأخير.

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

applyRowBanding()

تطبيق مظهر ربط الصف التلقائي على النطاق تتضمن عملية الربط تلقائيًا الرأس واللون بدون تذييل.

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

applyRowBanding(bandingTheme)

تطبيق مظهر ربط صف محدد على النطاق. تتضمن عملية الربط تلقائيًا الرأس واللون بدون تذييل.

المَعلمات

الاسمالنوعالوصف
bandingThemeBandingThemeمظهر ملوّن لتطبيقه على الصفوف في النطاق

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

applyRowBanding(bandingTheme, showHeader, showFooter)

يتم تطبيق مظهر تباين الصفوف المحدّد على النطاق مع ضبط الرؤوس والتذييلات المحدّدة.

المَعلمات

الاسمالنوعالوصف
bandingThemeBandingThemeمظهر ملوّن لتطبيقه على الصفوف في النطاق
showHeaderBooleanإذا كانت القيمة true، يتم تطبيق لون عنوان التصنيف الشامل على الصف الأول.
showFooterBooleanإذا تم ضبط true، سيتم تطبيق لون تذييل مظهر التصنيف على الصف الأخير.

رحلة العودة

Banding — النطاق الجديد

التفويض

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

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

autoFill(destination, series)

تملأ destinationRange بالبيانات استنادًا إلى البيانات في هذا النطاق. يتم تحديد القيم الجديدة أيضًا من خلال النوع series المحدّد. يجب أن يحتوي نطاق الوجهة على هذا النطاق ويمدّه في اتجاه واحد فقط. على سبيل المثال، يملأ ما يلي A1:A20 بسلسلة من الأرقام المتزايدة استنادًا إلى القيم الحالية في A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

المَعلمات

الاسمالنوعالوصف
destinationRangeالنطاق الذي تتم تعبئته تلقائيًا بالقيم يجب أن يحتوي نطاق الوجهة على هذا النطاق ويمدّه في اتجاه واحد فقط (أعلى أو أسفل أو يسار أو يمين).
seriesAutoFillSeriesنوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها.

التفويض

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

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

autoFillToNeighbor(series)

تحسب نطاقًا لتعبئة البيانات الجديدة بناءً على الخلايا المجاورة وملء هذا النطاق تلقائيًا بقيم جديدة استنادًا إلى البيانات المضمّنة في هذا النطاق. يتم تحديد هذه القيم الجديدة أيضًا من خلال النوع series المحدّد.

يراعي نطاق الوجهة الذي يتم احتسابه البيانات المحيطة لتحديد أماكن إدراج القيم الجديدة: وإذا كانت هناك بيانات على الجانب الأيمن أو الأيسر من العمود الذي يتم ملؤه تلقائيًا، لن تمتد القيم الجديدة إلا إلى جانب هذه البيانات المجاورة.

على سبيل المثال، إذا كانت السمة A1:A20 ممتلئة بسلسلة من الأرقام المتزايدة وتُسمى هذه الطريقة في النطاق B1:B4 الذي يحتوي على سلسلة من التواريخ، يتم إدخال القيم الجديدة فقط في B5:B20. بهذه الطريقة، فإن هذه القيم الجديدة "تلتزم" بالخلايا التي تحتوي على القيم في العمود A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

المَعلمات

الاسمالنوعالوصف
seriesAutoFillSeriesنوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها.

التفويض

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

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

breakApart()

قسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.

يعادل استدعاء هذه الدالة في نطاق اختيار نطاق والنقر على تنسيق -> دمج -> إلغاء الدمج.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

canEdit()

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

رحلة العودة

Booleantrue إذا كان لدى المستخدم الإذن لتعديل كل خلية في النطاق. false بخلاف ذلك.

التفويض

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

  • 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 range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clear()

محو نطاق المحتوى والتنسيقات

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clear(options)

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

// The code below clears range C2:G8 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

المَعلمات

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

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

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clearContent()

يمحو محتوى النطاق، مع ترك التنسيق بدون تغيير.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clearDataValidations()

محو قواعد التحقّق من صحة البيانات للنطاق

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clearFormat()

محو التنسيق لهذا النطاق

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

clearNote()

يؤدي إلى محو الملاحظة في الخلية أو الخلايا المحددة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

collapseGroups()

تصغير جميع المجموعات المضمّنة بالكامل ضمن النطاق إذا لم تكن المجموعة مضمّنة بالكامل ضمن النطاق، يتم تصغير المجموعة الموسّعة الأعمق التي تقع ضمن النطاق.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

copyFormatToRange(gridId, column, columnEnd, row, rowEnd)

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

للحصول على وصف تفصيلي لمَعلمة networkId، يمكنك الاطّلاع على getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

المَعلمات

الاسمالنوعالوصف
gridIdIntegerرقم التعريف الفريد لجدول البيانات في جدول البيانات، بغض النظر عن الموضع.
columnIntegerالعمود الأول للنطاق المستهدف.
columnEndIntegerعمود النهاية للنطاق المستهدف.
rowIntegerصف البدء للنطاق المستهدف.
rowEndIntegerصف نهاية النطاق المستهدَف.

التفويض

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

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

يمكن أيضًا مراجعة


copyFormatToRange(sheet, column, columnEnd, row, rowEnd)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

المَعلمات

الاسمالنوعالوصف
sheetSheetورقة البيانات المستهدفة.
columnIntegerالعمود الأول للنطاق المستهدف.
columnEndIntegerعمود النهاية للنطاق المستهدف.
rowIntegerصف البدء للنطاق المستهدف.
rowEndIntegerصف نهاية النطاق المستهدَف.

التفويض

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

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

copyTo(destination)

نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا يتم نسخ كل من القيم والتنسيق.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

المَعلمات

الاسمالنوعالوصف
destinationRangeنطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة.

التفويض

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

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

copyTo(destination, copyPasteType, transposed)

نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

المَعلمات

الاسمالنوعالوصف
destinationRangeنطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة.
copyPasteTypeCopyPasteTypeهو نوع يحدّد كيفية لصق محتوى النطاق للوجهة.
transposedBooleanما إذا كان يجب لصق النطاق في اتجاهه المحوّل.

التفويض

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

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

copyTo(destination, options)

نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا يتم نسخ كل من القيم والتنسيق تلقائيًا، ولكن يمكن إلغاء ذلك باستخدام الوسيطات المتقدمة.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

المَعلمات

الاسمالنوعالوصف
destinationRangeنطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة.
optionsObjectعنصر JavaScript يُحدِّد المعلّمات المتقدّمة، كما هو موضّح أدناه.

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

الاسمالنوعالوصف
formatOnlyBooleanتحدد أنه يجب نسخ التنسيق فقط
contentsOnlyBooleanتحدد أنه يجب نسخ المحتوى فقط

التفويض

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

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

copyValuesToRange(gridId, column, columnEnd, row, rowEnd)

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

للحصول على وصف تفصيلي لمَعلمة networkId، يمكنك الاطّلاع على getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

المَعلمات

الاسمالنوعالوصف
gridIdIntegerرقم التعريف الفريد لجدول البيانات في جدول البيانات، بغض النظر عن الموضع.
columnIntegerالعمود الأول للنطاق المستهدف.
columnEndIntegerعمود النهاية للنطاق المستهدف.
rowIntegerصف البدء للنطاق المستهدف.
rowEndIntegerصف نهاية النطاق المستهدَف.

التفويض

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

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

يمكن أيضًا مراجعة


copyValuesToRange(sheet, column, columnEnd, row, rowEnd)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

المَعلمات

الاسمالنوعالوصف
sheetSheetورقة البيانات المستهدفة.
columnIntegerالعمود الأول للنطاق المستهدف.
columnEndIntegerعمود النهاية للنطاق المستهدف.
rowIntegerصف البدء للنطاق المستهدف.
rowEndIntegerصف نهاية النطاق المستهدَف.

التفويض

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

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

createDataSourcePivotTable(dataSource)

ينشئ جدولاً محوريًا لمصدر بيانات فارغًا من مصدر البيانات، ويكون مرتبطًا بالخلية الأولى في هذا النطاق.

يوضّح هذا المثال كيفية إنشاء جدول محوري جديد لمصدر البيانات وضبطه.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

المَعلمات

الاسمالنوعالوصف
dataSourceDataSourceمصدر البيانات لإنشاء الجدول المحوري منه.

رحلة العودة

DataSourcePivotTable: الجدول المحوري لمصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

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

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

createDataSourceTable(dataSource)

ينشئ جدولاً فارغًا لمصدر البيانات من مصدر البيانات، ثابتًا في الخلية الأولى في هذا النطاق.

يوضّح هذا المثال كيفية إنشاء جدول مصدر بيانات جديد وضبطه.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

المَعلمات

الاسمالنوعالوصف
dataSourceDataSourceمصدر البيانات لإنشاء الجدول المحوري منه.

رحلة العودة

DataSourceTable: جدول مصدر البيانات الذي تم إنشاؤه حديثًا.

التفويض

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

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

createDeveloperMetadataFinder()

تعرض قيمة وصفية البيانات الوصفية لمطوّر البرامج للعثور على البيانات الوصفية لمطوّر البرامج داخل نطاق هذا النطاق. تقع البيانات الوصفية ضمن النطاق فقط إذا كانت مضمّنة فيه بالكامل. على سبيل المثال، لا تقع البيانات الوصفية المرتبطة بالصف "3:3" ضمن نطاق "A1:D5" ولكنها تقع ضمن النطاق "1:5".

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

رحلة العودة

DeveloperMetadataFinder: باحث عن البيانات الوصفية لمطوِّر البرامج للبحث عن البيانات الوصفية ضمن هذا النطاق


createFilter()

تنشئ فلترًا ويطبّقه على النطاق المحدّد في ورقة البيانات. لا يمكنك إنشاء أكثر من فلتر واحد في ورقة بيانات. للوصول إلى الفلتر وتعديله بعد إنشائه، استخدِم getFilter() أو Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
يمكن استخدام هذه الطريقة لإنشاء فلاتر لأوراق بيانات Grid، وهي النوع التلقائي من جداول البيانات. أوراق البيانات على شكل مربّعات هي أوراق بيانات غير مرتبطة بقاعدة بيانات. لإنشاء أنواع أخرى من الفلاتر، يُرجى الاطّلاع على ما يلي:

رحلة العودة

Filter — الفلتر الجديد

التفويض

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

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

createPivotTable(sourceData)

تنشئ هذه السياسة جدولاً محوريًا فارغًا من sourceData المحدّد الذي تم إرساؤه في الخلية الأولى في هذا النطاق.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

المَعلمات

الاسمالنوعالوصف
sourceDataRangeالبيانات المطلوب إنشاء الجدول المحوري منها.

رحلة العودة

PivotTable: PivotTable التي تم إنشاؤها حديثًا

التفويض

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

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

createTextFinder(findText)

تنشئ هذه الميزة نصًا للبحث عن النطاق، ويمكنها العثور على النص واستبداله في هذا النطاق.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

المَعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.

رحلة العودة

TextFinderTextFinder للنطاق


deleteCells(shiftDimension)

حذف هذا النطاق من الخلايا. يتم نقل البيانات الحالية في ورقة البيانات بجانب البُعد المقدّم نحو النطاق المحذوف.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

المَعلمات

الاسمالنوعالوصف
shiftDimensionDimensionالبُعد الذي يتم استخدامه لنقل البيانات الحالية.

التفويض

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

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

expandGroups()

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

getA1Notation()

لعرض وصف سلسلة للنطاق، بتدوين A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

رحلة العودة

String: وصف السلسلة للنطاق في تدوين A1.

التفويض

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

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

getBackground()

تعرض لون خلفية الخلية العلوية اليسرى في النطاق (مثلاً، '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

رحلة العودة

String: رمز اللون في الخلفية

التفويض

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

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

getBackgroundObject()

لعرض لون خلفية الخلية العلوية اليسرى في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

رحلة العودة

Color - لون خلفية الخلية العلوية اليسرى في النطاق

التفويض

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

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

getBackgroundObjects()

لعرض ألوان خلفية الخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

رحلة العودة

Color[][]: مصفوفة ثنائية الأبعاد من ألوان الخلفية.

التفويض

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

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

getBackgrounds()

تعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من رموز الألوان للخلفيات.

التفويض

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

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

getBandings()

تعرض جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

رحلة العودة

Banding[]: جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق.

التفويض

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

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

getCell(row, column)

لعرض خلية معيّنة ضمن نطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

المَعلمات

الاسمالنوعالوصف
rowIntegerصف الخلية بالنسبة إلى النطاق.
columnIntegerعمود الخلية المرتبط بالنطاق.

رحلة العودة

Range — نطاق يحتوي على خلية واحدة بالإحداثيات المحددة.

التفويض

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

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

getColumn()

عرض موضع عمود البدء لهذا النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

رحلة العودة

Integer: موضع عمود بداية النطاق في جدول البيانات.

التفويض

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

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

getDataRegion()

تعرض نسخة من النطاق الموسّع في العناصر الأساسية Direction الرئيسية لتغطية جميع الخلايا المجاورة التي تحتوي على بيانات. إذا كان النطاق محاطًا بخلايا فارغة بما في ذلك الخلايا ذات خطوط قطرية، يتم عرض النطاق نفسه. يشبه ذلك اختيار النطاق وكتابة Ctrl+A في المحرّر.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

رحلة العودة

Range: منطقة بيانات النطاق أو نطاق لجدول البيانات بالكامل.

التفويض

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

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

getDataRegion(dimension)

تعرض نسخة من النطاق الموسّع Direction.UP وDirection.DOWN إذا كانت السمة المحدّدة هي Dimension.ROWS، أو Direction.NEXT وDirection.PREVIOUS إذا كانت السمة Dimension.COLUMNS. يعتمد توسيع النطاق على اكتشاف البيانات بجانب النطاق المنظَّم على شكل جدول. يشمل النطاق الموسّع جميع الخلايا المجاورة التي تحتوي على بيانات ضمن السمة المحدّدة، بما في ذلك حدود الجدول. إذا كان النطاق الأصلي محاطًا بخلايا فارغة في البُعد المحدّد، يتم عرض النطاق نفسه. تشبه هذه الطريقة اختيار النطاق وكتابة Ctrl+Space للأعمدة أو Shift+Space للصفوف في أداة التعديل.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

المَعلمات

الاسمالنوعالوصف
dimensionDimensionالبُعد الذي يتم استخدامه لتوسيع النطاق

رحلة العودة

Range: منطقة بيانات النطاق أو نطاق يغطي كل عمود أو كل صف ممدّد بالنطاق الأصلي.

التفويض

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

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

getDataSourceFormula()

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

رحلة العودة

DataSourceFormulaDataSourceFormula للخلية.

التفويض

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

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

getDataSourceFormulas()

تعرض DataSourceFormula للخلايا في النطاق.

رحلة العودة

DataSourceFormula[]: مصفوفة من DataSourceFormula.

التفويض

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

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

getDataSourcePivotTables()

الحصول على جميع الجداول المحورية لمصدر البيانات التي تتداخل مع النطاق

رحلة العودة

DataSourcePivotTable[] - قائمة بالجداول المحورية لمصدر البيانات

التفويض

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

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

getDataSourceTables()

للحصول على جميع جداول مصادر البيانات التي تتقاطع مع النطاق.

رحلة العودة

DataSourceTable[] - قائمة بجداول مصادر البيانات

التفويض

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

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

getDataSourceUrl()

عرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء الرسوم البيانية وطلبات البحث.

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

رحلة العودة

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

التفويض

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

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

getDataTable()

اعرض البيانات داخل هذا الكائن كجدول بيانات.

رحلة العودة

DataTable - البيانات كجدول بيانات.


getDataTable(firstRowIsHeader)

ويمكنك عرض البيانات داخل هذا النطاق كجدول بيانات.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

المَعلمات

الاسمالنوعالوصف
firstRowIsHeaderBooleanلتحديد ما إذا كنت تريد التعامل مع الصف الأول على أنه عنوان.

رحلة العودة

DataTable - البيانات كجدول بيانات.

التفويض

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

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

getDataValidation()

تعرض قاعدة التحقق من صحة البيانات للخلية أعلى اليمين في النطاق. إذا لم يتم ضبط التحقق من صحة البيانات في الخلية، ستعرض هذه الطريقة القيمة null.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

رحلة العودة

DataValidation: قاعدة التحقُّق من البيانات للخلية العلوية اليمنى في النطاق

التفويض

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

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

getDataValidations()

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

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

رحلة العودة

DataValidation[][]: مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات المرتبطة بالخلايا في النطاق.

التفويض

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

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

getDeveloperMetadata()

الحصول على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق

رحلة العودة

DeveloperMetadata[]: البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق

التفويض

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

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

getDisplayValue()

تعرض القيمة المعروضة للخلية أعلى اليمين في النطاق. القيمة هي String. تأخذ القيمة المعروضة في الاعتبار تنسيق التاريخ والوقت وتنسيق العملة، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد لغة جدول البيانات. تعرض الخلايا الفارغة سلسلة فارغة.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

رحلة العودة

String: القيمة المعروضة في هذه الخلية

التفويض

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

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

getDisplayValues()

لعرض شبكة القيم المستطيلة لهذا النطاق.

تعرض صفيفًا ثنائي الأبعاد للقيم المعروضة، تمت فهرستها حسب الصف، ثم حسب العمود. والقيمتان هي String عنصر. وتراعي القيمة المعروضة تنسيق التاريخ والوقت والعملة، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد جدول البيانات. يتم تمثيل الخلايا الفارغة بسلسلة فارغة في المصفوفة. يُرجى العِلم أنّه عندما يبدأ فهرس النطاق عند 1, 1، تتم فهرسة مصفوفة JavaScript من [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

رحلة العودة

String[][] — مصفوفة من الأبعاد ثنائية القيم.

التفويض

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

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

getFilter()

تعرض الفلتر في ورقة البيانات التي ينتمي إليها هذا النطاق، أو null في حال عدم توفّر فلتر في ورقة البيانات.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

رحلة العودة

Filter — الفلتر

التفويض

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

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

getFontColorObject()

لعرض لون خط الخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

رحلة العودة

Color - لون خط الخلية العلوية اليسرى في النطاق.

التفويض

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

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

getFontColorObjects()

تعرض ألوان الخط للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

رحلة العودة

Color[][]: مصفوفة ثنائية الأبعاد من ألوان الخطوط المرتبطة بالخلايا في النطاق.

التفويض

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

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

getFontFamilies()

لعرض مجموعات الخطوط للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من مجموعات الخطوط المرتبطة بخلايا في النطاق.

التفويض

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

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

getFontFamily()

تعرض مجموعة الخطوط للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

رحلة العودة

String - مجموعة الخطوط للخلية

التفويض

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

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

getFontLine()

يعرض نمط الخط للخلية في أعلى يمين النطاق ('underline' أو 'line-through' أو 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

رحلة العودة

String: خط الخط

التفويض

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

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

getFontLines()

للحصول على نمط الخط للخلايا في النطاق ('underline' أو 'line-through' أو 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][] — مصفوفة ثنائية الأبعاد من خطوط الخطوط المرتبطة بالخلايا في النطاق.

التفويض

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

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

getFontSize()

لعرض حجم الخط بحجم النقطة للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

رحلة العودة

Integer : حجم الخط في حجم النقاط

التفويض

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

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

getFontSizes()

تعرض أحجام الخط للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

Integer[][] — مصفوفة ثنائية الأبعاد من أحجام الخطوط للنص المرتبط بخلايا في النطاق.

التفويض

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

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

getFontStyle()

لعرض نمط الخط ('italic' أو 'normal') للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

رحلة العودة

String - نمط خط النص في الخلية.

التفويض

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

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

getFontStyles()

لعرض أنماط الخط للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من أنماط الخطوط للنص المرتبط بالخلايا في النطاق.

التفويض

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

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

getFontWeight()

لعرض وزن الخط (عادي/غامق) للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

رحلة العودة

String — كثافة خط النص في الخلية

التفويض

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

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

getFontWeights()

لعرض أوزان الخط للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][] — مصفوفة ثنائية الأبعاد من أحجام الخطوط للنص المرتبط بالخلايا في النطاق.

التفويض

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

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

getFormula()

لعرض الصيغة (تدوين A1) للخلية أعلى يمين النطاق، أو سلسلة فارغة إذا كانت الخلية فارغة أو لا تحتوي على صيغة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

رحلة العودة

String — صيغة الخلية

التفويض

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

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

getFormulaR1C1()

تعرض الصيغة (تدوين R1C1) لخلية معينة، أو null إذا لم تكن موجودة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

رحلة العودة

String — الصيغة بتدوين R1C1.

التفويض

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

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

getFormulas()

لعرض الصيغ (تدوين A1) للخلايا في النطاق. الإدخالات في المصفوفة ثنائية الأبعاد هي سلاسل فارغة للخلايا التي لا تحتوي على صيغة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

رحلة العودة

String[][] — مصفوفة ثنائية الأبعاد للصيغ بتنسيق سلسلة.

التفويض

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

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

getFormulasR1C1()

تعرض الصيغ (تدوين R1C1) للخلايا في النطاق. الإدخالات في المصفوفة الثنائية الأبعاد null للخلايا التي لا تحتوي على صيغة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

رحلة العودة

String[][] — مصفوفة ثنائية الأبعاد للصيغ بتدوين R1C1.

التفويض

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

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

getGridId()

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

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

رحلة العودة

Integer : رقم تعريف الشبكة لورقة البيانات الرئيسية

التفويض

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

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

getHeight()

تعرض ارتفاع النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

رحلة العودة

Integer: ارتفاع النطاق.

التفويض

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

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

getHorizontalAlignment()

لعرض المحاذاة الأفقية للنص (يسار/وسم/يمين) للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

رحلة العودة

String — المحاذاة الأفقية للنص في الخلية.

التفويض

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

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

getHorizontalAlignments()

تعرض المحاذاة الأفقية للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من المحاذاة الأفقية للنص المرتبط بخلايا في النطاق.

التفويض

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

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

getLastColumn()

لعرض موضع عمود النهاية.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

رحلة العودة

Integer - موضع عمود نهاية النطاق في جدول البيانات.

التفويض

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

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

getLastRow()

لعرض موضع صف النهاية.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

رحلة العودة

Integer: موضع صف نهاية النطاق في جدول البيانات

التفويض

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

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

getMergedRanges()

تعرض صفيفًا من Range كائنات تمثّل خلايا مدمَجة تكون بالكامل داخل النطاق الحالي أو تحتوي على خلية واحدة على الأقل في النطاق الحالي.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

رحلة العودة

Range[]: مصفوفة من Range عنصر، تمثل خلايا مدمَجة تتداخل مع النطاق.


getNextDataCell(direction)

بدءًا من الخلية في العمود والصف الأول من النطاق، تعرض الخلية التالية في الاتجاه المحدّد الذي يمثل حافة نطاق متجاور من الخلايا يحتوي على بيانات داخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه. يعادل ذلك كتابة Ctrl+[arrow key] في المحرِّر.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

المَعلمات

الاسمالنوعالوصف
directionDirectionالاتجاه المطلوب للعثور على خلية حافة منطقة البيانات التالية فيها.

رحلة العودة

Range - خلية حافة منطقة البيانات أو الخلية على حافة جدول البيانات.

التفويض

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

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

getNote()

لعرض الملاحظة المرتبطة بالنطاق المحدد.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

رحلة العودة

String — الملاحظة المرتبطة بالخلية المحددة.

التفويض

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

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

getNotes()

لعرض الملاحظات المرتبطة بالخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من الملاحظات المرتبطة بالخلايا في النطاق.

التفويض

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

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

getNumColumns()

لعرض عدد الأعمدة في هذا النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

رحلة العودة

Integer: عدد الأعمدة في هذا النطاق.

التفويض

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

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

getNumRows()

لعرض عدد الصفوف في هذا النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

رحلة العودة

Integer: عدد الصفوف في هذا النطاق

التفويض

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

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

getNumberFormat()

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

رحلة العودة

String - تنسيق الرقم للخلية العلوية اليمنى من النطاق.

التفويض

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

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

getNumberFormats()

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

رحلة العودة

String[][] — مصفوفة ثنائية الأبعاد من تنسيقات الأرقام.

التفويض

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

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

getRichTextValue()

تعرض قيمة النص المنسق للخلية أعلى يمين النطاق، أو null إذا لم تكن قيمة الخلية نصًا.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

رحلة العودة

RichTextValue: قيمة النص المنسّق للخلية العلوية اليسرى في النطاق أو null إذا لم تكن قيمة الخلية نصّاً.

التفويض

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

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

getRichTextValues()

تعرض قيم النص المنسّق للخلايا في النطاق.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

رحلة العودة

RichTextValue[][] — مصفوفة ثنائية الأبعاد من قيم النص المنسق.

التفويض

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

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

getRow()

لعرض موضع الصف لهذا النطاق. يتطابق مع getالصفوفIndex().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

رحلة العودة

Integer: موضع الصف للنطاق.

التفويض

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

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

getRowIndex()

لعرض موضع الصف لهذا النطاق. يتطابق مع getالصفوف().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

رحلة العودة

Integer: موضع الصف للنطاق.

التفويض

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

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

يمكن أيضًا مراجعة


getSheet()

تعرض ورقة البيانات التي ينتمي إليها هذا النطاق.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

رحلة العودة

Sheet: ورقة البيانات التي ينتمي إليها هذا النطاق.

التفويض

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

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

getTextDirection()

لعرض اتجاه النص للخلية اليمنى العليا من النطاق. تعرض null إذا تم تحديد اتجاه نص الخلية مع الاكتشاف التلقائي.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

رحلة العودة

TextDirection — اتجاه النص أعلى الخلية اليسرى في النطاق.

التفويض

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

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

getTextDirections()

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

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

رحلة العودة

TextDirection[][] — مصفوفة ثنائية الأبعاد من الاتجاهات النصية.

التفويض

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

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

getTextRotation()

لعرض إعدادات تدوير النص للخلية اليمنى العليا من النطاق.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

رحلة العودة

TextRotation: إعدادات تدوير النص

التفويض

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

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

getTextRotations()

لعرض إعدادات تدوير النص للخلايا في النطاق.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

رحلة العودة

TextRotation[][] - مصفوفة ثنائية الأبعاد من التدوير النصي المرتبط بخلايا في النطاق.

التفويض

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

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

getTextStyle()

لعرض نمط النص للخلية العلوية اليمنى من النطاق.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

رحلة العودة

TextStyle - نمط النص أعلى الخلية اليسرى في النطاق.

التفويض

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

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

getTextStyles()

لعرض أنماط النص للخلايا في النطاق.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

رحلة العودة

TextStyle[][] — مصفوفة ثنائية الأبعاد من أنماط النص.

التفويض

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

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

getValue()

لعرض قيمة الخلية في أعلى يمين النطاق. قد تكون القيمة من النوع Number أو Boolean أو Date أو String حسب قيمة الخلية. تعرض الخلايا الفارغة سلسلة فارغة.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

رحلة العودة

Object: القيمة في هذه الخلية

التفويض

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

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

getValues()

لعرض شبكة القيم المستطيلة لهذا النطاق.

تعرض صفيفًا ثنائي الأبعاد من القيم التي تمت فهرستها حسب الصف ثم حسب العمود. قد تكون القيم من النوع Number أو Boolean أو Date أو String، بناءً على قيمة الخلية. يتم تمثيل الخلايا الفارغة بسلسلة فارغة في المصفوفة. يُرجى العِلم أنّه عند بدء فهرس النطاق من 1, 1، تتم فهرسة مصفوفة JavaScript من [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
في تطبيقات الويب، لا تكون القيمة Date مَعلمة قانونية. يتعذّر على getValues() عرض البيانات إلى تطبيق ويب إذا كان النطاق يحتوي على خلية تحتوي على القيمة Date. وبدلاً من ذلك، يمكنك تحويل جميع القيم التي تم استردادها من ورقة البيانات إلى عنصر JavaScript أساسي متوافق مثل Number أو Boolean أو String.

رحلة العودة

Object[][] — مصفوفة من الأبعاد ثنائية القيم.

التفويض

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

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

getVerticalAlignment()

تعرض المحاذاة العمودية (أعلى/الوسط/الأسفل) للخلية في أعلى يمين النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

رحلة العودة

String — المحاذاة العمودية للنص في الخلية.

التفويض

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

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

getVerticalAlignments()

تعرض المحاذاة العمودية للخلايا في النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

رحلة العودة

String[][]: مصفوفة ثنائية الأبعاد من المحاذاة العمودية للنص المرتبط بخلايا في النطاق.

التفويض

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

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

getWidth()

لعرض عرض النطاق في الأعمدة.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

رحلة العودة

Integer: عدد الأعمدة في النطاق

التفويض

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

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

getWrap()

لعرض ما إذا كان النص في لفّة الخلية. ولوضع استراتيجية أكثر دقة للالتفاف، استخدِم getWrapStrategy().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

رحلة العودة

Boolean: ما إذا كان النص في هذه الخلية يلتفّ أم لا.

التفويض

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

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

getWrapStrategies()

لعرض استراتيجيات التفاف النص للخلايا في النطاق.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

رحلة العودة

WrapStrategy[][]: مصفوفة ثنائية الأبعاد من استراتيجيات التفاف النص.

التفويض

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

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

getWrapStrategy()

لعرض استراتيجية التفاف النص للخلية اليمنى العليا من النطاق.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

رحلة العودة

WrapStrategy — استراتيجية التفاف النص للخلية اليمنى العليا في النطاق.

التفويض

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

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

getWraps()

لعرض ما إذا كان النص في التفاف الخلايا. ولوضع استراتيجية أكثر دقة للالتفاف، استخدِم getWrapStrategies().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

رحلة العودة

Boolean[][]: مصفوفة ثنائية الأبعاد من المحاذاة العمودية للنص المرتبط بخلايا في النطاق.

التفويض

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

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

insertCells(shiftDimension)

إدخال خلايا فارغة في هذا النطاق تحتفظ الخلايا الجديدة بأي تنسيق موجود في الخلايا التي كانت تشغل هذا النطاق في السابق. يتم نقل البيانات الحالية في ورقة البيانات على طول البُعد المقدّم من النطاق المُدرَج.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

المَعلمات

الاسمالنوعالوصف
shiftDimensionDimensionالبُعد الذي يتم استخدامه لنقل البيانات الحالية.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

insertCheckboxes()

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

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

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

insertCheckboxes(checkedValue)

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

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

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

insertCheckboxes(checkedValue, uncheckedValue)

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

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

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

isBlank()

تعرض true إذا كان النطاق فارغًا تمامًا.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

رحلة العودة

Boolean - true إذا كان النطاق فارغًا، أو false بخلاف ذلك.

التفويض

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

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

isChecked()

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

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

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

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

رحلة العودة

Boolean: true إذا تم وضع علامة في جميع الخلايا في النطاق، أو false إذا تم وضع علامة في جميع الخلايا في النطاق، أو null إذا لم يتم وضع علامة في أي من الخلايا أو لم يكن لديك التحقق من صحة بيانات المربّعات.

التفويض

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

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

isEndColumnBounded()

تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10 أو B:B التي تقتصر على الأعمدة في نهاية النطاق، تعرض هذه الطريقة true. وبالنسبة إلى النطاقات 3:7 أو A1:5، التي تقتصر على صفوف معيّنة في نهاية النطاق، تعرض هذه الطريقة false.

 // Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

رحلة العودة

Boolean - true إذا كانت نهاية النطاق مرتبطة بعمود معيّن، false بخلاف ذلك.

التفويض

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

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

isEndRowBounded()

تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بصف معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10 أو 3:7 التي تتضمن صفوفًا في نهاية النطاق، تعرض هذه الطريقة true. وبالنسبة إلى النطاقات B:B أو A1:C، التي تقتصر على أعمدة معيّنة في نهاية النطاق، تعرض هذه الطريقة false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

رحلة العودة

Booleantrue إذا كانت نهاية النطاق ترتبط بصف محدد؛ false بخلاف ذلك.

التفويض

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

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

isPartOfMerge()

لعرض true إذا كانت الخلايا في النطاق الحالي تتداخل مع أي خلايا مدمجة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

رحلة العودة

Booleantrue إذا تداخل النطاق مع أي خلايا مدمَجة، وإلا سيتم عرض false.


isStartColumnBounded()

تحدّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10 أو B:B التي ترتبط بالأعمدة في بداية النطاق، تعرض هذه الطريقة true. وبالنسبة إلى النطاق 3:7، الذي يقتصر على صف فقط في بداية النطاق، تعرض هذه الطريقة false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

رحلة العودة

Booleantrue إذا كانت بداية النطاق مرتبطة بعمود محدد، false بخلاف ذلك.

التفويض

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

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

isStartRowBounded()

تحدِّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بصف معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10 أو 3:7 التي ترتبط بالصفوف في بداية النطاق، تعرض هذه الطريقة true. وبالنسبة إلى النطاق B:B، الذي يقتصر على عمود معيّن في بداية النطاق، تعرض هذه الطريقة false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

رحلة العودة

Booleantrue إذا كانت بداية النطاق مرتبطة بصف محدد؛ false بخلاف ذلك.

التفويض

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

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

merge()

تدمج الخلايا في النطاق معًا في وحدة واحدة.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

mergeAcross()

ادمج الخلايا في النطاق في أعمدة النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

mergeVertically()

تدمج الخلايا في النطاق معًا.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

moveTo(target)

قص ولصق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق الهدف.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

المَعلمات

الاسمالنوعالوصف
targetRangeنطاق مستهدف لنسخ هذا النطاق، ويكون موضع الخلية في أعلى اليمين ملائمًا.

التفويض

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

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

offset(rowOffset, columnOffset)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

المَعلمات

الاسمالنوعالوصف
rowOffsetIntegerعدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق.
columnOffsetIntegerعدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق.

رحلة العودة

Range: هذا النطاق للسلسلة.


offset(rowOffset, columnOffset, numRows)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

المَعلمات

الاسمالنوعالوصف
rowOffsetIntegerعدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق.
columnOffsetIntegerعدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق.
numRowsIntegerالارتفاع في صفوف النطاق الجديد.

رحلة العودة

Range: هذا النطاق للسلسلة.


offset(rowOffset, columnOffset, numRows, numColumns)

تعرض نطاقًا جديدًا بالنسبة إلى النطاق الحالي، حيث تتم إزاحة النقطة العلوية اليسرى من النطاق الحالي بالصفوف والأعمدة المعيّنة، بالارتفاع والعرض المحددَين في الخلايا.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

المَعلمات

الاسمالنوعالوصف
rowOffsetIntegerعدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق.
columnOffsetIntegerعدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق.
numRowsIntegerالارتفاع في صفوف النطاق الجديد.
numColumnsIntegerالعرض في أعمدة النطاق الجديد.

رحلة العودة

Range: هذا النطاق للسلسلة.


protect()

تنشئ عنصرًا يمكن أن يحمي النطاق من تعديله باستثناء المستخدمين الذين لديهم إذن. إلى أن يُغيّر النص البرمجي قائمة أدوات التحرير للنطاق (من خلال استدعاء Protection.removeEditor(emailAddress) أو Protection.removeEditor(user) أو Protection.removeEditors(emailAddresses) أو Protection.addEditor(emailAddress) أو Protection.addEditor(user) أو Protection.addEditors(emailAddresses) أو ضبط قيمة جديدة لـ Protection.setDomainEdit(editable))، تتطابق الأذونات مع أذونات جدول البيانات نفسه، ما يعني أن النطاق لا يبقى محميًا. إذا كان النطاق محميًا من قبل، تنشئ هذه الطريقة نطاقًا محميًا جديدًا يتداخل مع النطاق الحالي. إذا كانت الخلية محمية بواسطة نطاقات محمية متعددة، وكان أي منها يمنع مستخدمًا معينًا من تعديل الخلية، لا يُسمح لهذا المستخدم بتعديل الخلية.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

رحلة العودة

Protection: كائن يمثّل إعدادات الحماية.

التفويض

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

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

randomize()

الترتيب العشوائي للصفوف في النطاق المحدّد

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

  • 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 range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

removeDuplicates()

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

رحلة العودة

Range: النطاق الناتج بعد إزالة النُسخ المكرّرة وينخفض حجم النطاق بمقدار صف لكل صف تمت إزالته.

التفويض

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

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

removeDuplicates(columnsToCompare)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

المَعلمات

الاسمالنوعالوصف
columnsToCompareInteger[]الأعمدة المطلوب تحليلها بحثًا عن قيم مكرّرة. وفي حال عدم توفير أي أعمدة، يتم تحليل جميع الأعمدة بحثًا عن التكرارات.

رحلة العودة

Range: النطاق الناتج بعد إزالة النُسخ المكرّرة وينخفض حجم النطاق بمقدار صف لكل صف تمت إزالته.

التفويض

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

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

setBackground(color)

لضبط لون خلفية جميع الخلايا في النطاق في تدوين CSS (مثل '#ffffff' أو 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setBackgroundObject(color)

ضبط لون الخلفية لجميع الخلايا في النطاق

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

المَعلمات

الاسمالنوعالوصف
colorColorلون الخلفية المطلوب ضبطه، ويؤدي قيمة null إلى إعادة ضبط لون الخلفية.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setBackgroundObjects(color)

لضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

المَعلمات

الاسمالنوعالوصف
colorColor[][]مصفوفة ثنائية الأبعاد من الألوان، إعادة ضبط قيم null للون

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setBackgroundRGB(red, green, blue)

لضبط الخلفية على اللون المعنيّ باستخدام قيم RGB (العدد الصحيح بين 0 و255 شاملاً).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

المَعلمات

الاسمالنوعالوصف
redIntegerالقيمة الحمراء بتدوين RGB
greenIntegerالقيمة الخضراء بتدوين RGB
blueIntegerالقيمة الزرقاء في ترميز RGB

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setBackgrounds(color)

لضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق). تظهر الألوان بتدوين CSS (مثل '#ffffff' أو 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

المَعلمات

الاسمالنوعالوصف
colorString[][]مصفوفة ثنائية الأبعاد من الألوان في تدوين CSS (مثل '#ffffff' أو 'white'). تؤدي قيم null إلى إعادة ضبط اللون.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

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

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.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 بلا تغيير.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

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

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

المَعلمات

الاسمالنوعالوصف
topBooleantrue بلا حدود، وfalse بلا حدود، وnull بلا تغيير.
leftBooleantrue بلا حدود، وfalse بلا حدود، وnull بلا تغيير.
bottomBooleantrue بلا حدود، وfalse بلا حدود، وnull بلا تغيير.
rightBooleantrue بلا حدود، وfalse بلا حدود، وnull بلا تغيير.
verticalBooleantrue للحدود العمودية الداخلية، false لبلا، وnull بلا تغيير.
horizontalBooleantrue للحدود الأفقية الداخلية، وfalse للعدم، وnull بلا تغيير.
colorStringلون في تدوين CSS (مثل '#ffffff' أو 'white'null للون التلقائي (أسود).
styleBorderStyleنمط للحدود، null للنمط التلقائي (متغيّر).

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setDataValidation(rule)

لضبط قاعدة واحدة للتحقق من صحة البيانات لجميع الخلايا في النطاق.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

المَعلمات

الاسمالنوعالوصف
ruleDataValidationيجب ضبط قاعدة التحقق من صحة البيانات، أو null لإزالة التحقق من صحة البيانات.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setDataValidations(rules)

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

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

المَعلمات

الاسمالنوعالوصف
rulesDataValidation[][]مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات التي يجب ضبطها، حيث تزيل قيم null التحقّق من صحة البيانات.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontColor(color)

لضبط لون الخط في تدوين CSS (مثل '#ffffff' أو 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontColorObject(color)

لضبط لون الخط للنطاق المحدّد.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

المَعلمات

الاسمالنوعالوصف
colorColorلون الخط المطلوب ضبطه، ويؤدي ضبط قيمة null إلى إعادة ضبط اللون.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontColorObjects(colors)

تُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

المَعلمات

الاسمالنوعالوصف
colorsColor[][]مصفوفة ثنائية الأبعاد من الألوان، إعادة ضبط قيم null لون الخط

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontColors(colors)

تُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق). تظهر الألوان بتدوين CSS (مثل '#ffffff' أو 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

المَعلمات

الاسمالنوعالوصف
colorsObject[][]مصفوفة ثنائية الأبعاد من الألوان في تدوين CSS (مثل '#ffffff' أو 'white'). تؤدي قيم null إلى إعادة ضبط اللون.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontFamilies(fontFamilies)

تُستخدم شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع الأبعاد لهذا النطاق). ومن أمثلة مجموعات الخطوط "Family" أو "Helvetica".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

المَعلمات

الاسمالنوعالوصف
fontFamiliesObject[][]مصفوفة ثنائية الأبعاد من مجموعات الخطوط، حيث تعيد قيم null ضبط مجموعة الخطوط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontFamily(fontFamily)

ضبط مجموعة الخطوط، مثل "xxx" أو "Helvetica".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

المَعلمات

الاسمالنوعالوصف
fontFamilyStringمجموعة الخطوط المطلوب ضبطها، ويؤدي ضبط قيمة null إلى إعادة ضبط مجموعة الخطوط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontLine(fontLine)

لضبط نمط خط الخط للنطاق المحدَّد ('underline' أو 'line-through' أو 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontLines(fontLines)

تضبط شبكة مستطيلة بأنماط خطوط (يجب أن تتطابق مع سمات هذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

المَعلمات

الاسمالنوعالوصف
fontLinesObject[][]مصفوفة ثنائية الأبعاد لأنماط خط الخط ('underline' أو 'line-through' أو 'none')؛ تؤدي قيم null إلى إعادة ضبط نمط خط الخط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontSize(size)

لضبط حجم الخط، بحيث يكون الحجم بحجم النقطة المطلوب استخدامه

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontSizes(sizes)

لتحديد شبكة مستطيلة بأحجام خطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق). المقاسات بالنقاط.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

المَعلمات

الاسمالنوعالوصف
sizesObject[][]مصفوفة ثنائية الأبعاد من الأحجام.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontStyle(fontStyle)

يمكنك ضبط نمط الخط للنطاق المحدَّد ('italic' أو 'normal').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

المَعلمات

الاسمالنوعالوصف
fontStyleStringنمط الخط، إما 'italic' أو 'normal'، ويؤدي استخدام القيمة null إلى إعادة ضبط نمط الخط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontStyles(fontStyles)

تُستخدم شبكة مستطيلة لأنماط الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

المَعلمات

الاسمالنوعالوصف
fontStylesObject[][]مصفوفة ثنائية الأبعاد من أنماط الخطوط، إما 'italic' أو 'normal'؛ أو تعيد قيم null ضبط نمط الخط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontWeight(fontWeight)

ضبط كثافة الخط للنطاق المحدَّد (عادي/غامق)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

المَعلمات

الاسمالنوعالوصف
fontWeightStringويؤدي كثافة الخط إما 'bold' أو 'normal' إلى إعادة ضبط قيمة الخط بمقدار null.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFontWeights(fontWeights)

لإعداد شبكة مستطيلة بأوزان الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق). ومن أمثلة سماكة الخط "غامق".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

المَعلمات

الاسمالنوعالوصف
fontWeightsObject[][]مصفوفة ثنائية الأبعاد من ترجيح الخط، إما 'bold' أو 'normal'؛ تعيد قيم null ضبط كثافة الخط.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFormula(formula)

تُعدِّل الصيغة لهذا النطاق. يجب أن تكون الصيغة المحددة بتدوين A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

المَعلمات

الاسمالنوعالوصف
formulaStringسلسلة تمثّل الصيغة المراد ضبطها للخلية.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFormulaR1C1(formula)

تُعدِّل الصيغة لهذا النطاق. يجب أن تكون الصيغة المحددة بتدوين R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFormulas(formulas)

تضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق). يجب أن تكون الصيغ المحددة في تدوين A1. تستخدم هذه الطريقة صفيفًا ثنائي الأبعاد للصيغ المفهرَسة حسب الصف ثم حسب العمود. يجب أن تتوافق أبعاد الصفيف مع أبعاد النطاق.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

المَعلمات

الاسمالنوعالوصف
formulasString[][]مصفوفة سلسلة ثنائية الأبعاد من الصيغ.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setFormulasR1C1(formulas)

تضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق). يجب أن تكون الصيغ المحددة بتدوين R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

المَعلمات

الاسمالنوعالوصف
formulasString[][]مصفوفة ثنائية الأبعاد من الصيغ بتنسيق R1C1.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setHorizontalAlignment(alignment)

اضبط المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المحدَّد (يسارًا/وسطًا/يمينًا).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setHorizontalAlignments(alignments)

لضبط شبكة مستطيلة للمحاذاة الأفقية. راجع setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

المَعلمات

الاسمالنوعالوصف
alignmentsObject[][]مصفوفة ثنائية الأبعاد من المحاذاة، إما 'left' أو 'center' أو 'normal'. تؤدي قيمة null إلى إعادة ضبط المحاذاة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

يمكن أيضًا مراجعة


setNote(note)

لضبط الملاحظة على القيمة المحدّدة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setNotes(notes)

تُستخدم شبكة مستطيلة للملاحظات (يجب أن تتطابق مع الأبعاد لهذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

المَعلمات

الاسمالنوعالوصف
notesObject[][]مصفوفة ثنائية الأبعاد من الملاحظات، تزيل قيم null الملاحظة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

يمكن أيضًا مراجعة


setNumberFormat(numberFormat)

لضبط تنسيق الرقم أو التاريخ على سلسلة التنسيق المحددة. يتم وصف أنماط التنسيق المقبولة في وثائق واجهة برمجة تطبيقات جداول بيانات Google.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setNumberFormats(numberFormats)

تحدّد شبكة مستطيلة بتنسيقات الأرقام أو التواريخ (يجب أن تتطابق مع سمات هذا النطاق). وتكون القيم هي سلاسل لأنماط التنسيق كما هو موضّح في المستندات المتعلّقة بواجهة برمجة تطبيقات "جداول بيانات Google".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

المَعلمات

الاسمالنوعالوصف
numberFormatsObject[][]مصفوفة ثنائية الأبعاد من تنسيقات الأرقام.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setRichTextValue(value)

لضبط قيمة النص المنسق للخلايا في النطاق

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

المَعلمات

الاسمالنوعالوصف
valueRichTextValueقيمة النص المنسّق المطلوب.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setRichTextValues(values)

تضبط شبكة مستطيلة من قيم النص المنسّق.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

المَعلمات

الاسمالنوعالوصف
valuesRichTextValue[][]قيم النص المنسّق المطلوبة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextDirection(direction)

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

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

المَعلمات

الاسمالنوعالوصف
directionTextDirectionاتجاه النص المطلوب، وإذا كان null يتم استنتاج الاتجاه قبل الإعداد

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextDirections(directions)

تُستخدم شبكة مستطيلة للاتجاهات النصية. وإذا كان الاتجاه المحدّد هو null، يتم استنتاج التوجيه، ثم ضبطه.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

المَعلمات

الاسمالنوعالوصف
directionsTextDirection[][]الاتجاهات النصية المطلوبة، وإذا كان الاتجاه المحدّد هو null، يتم استنتاجه قبل الإعداد.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextRotation(degrees)

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

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

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextRotation(rotation)

لضبط إعدادات تدوير النص للخلايا في النطاق.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

المَعلمات

الاسمالنوعالوصف
rotationTextRotationإعدادات تدوير النص المطلوبة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextRotations(rotations)

تُستخدم شبكة مستطيلة لتدوير النصوص.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

المَعلمات

الاسمالنوعالوصف
rotationsTextRotation[][]إعدادات تدوير النص المطلوبة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextStyle(style)

لضبط نمط النص للخلايا في النطاق.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

المَعلمات

الاسمالنوعالوصف
styleTextStyleنمط النص المطلوب.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setTextStyles(styles)

تضبط شبكة مستطيلة من أنماط النص.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

المَعلمات

الاسمالنوعالوصف
stylesTextStyle[][]أنماط النص المطلوبة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setValue(value)

تحدّد قيمة النطاق. يمكن أن تكون القيمة رقمية أو سلسلة أو منطقية أو تاريخ. إذا كان يبدأ بـ '='، يتم تفسيره كصيغة.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setValues(values)

تُستخدم شبكة مستطيلة من القيم (يجب أن تتطابق مع الأبعاد لهذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

المَعلمات

الاسمالنوعالوصف
valuesObject[][]مصفوفة ثنائية الأبعاد من القيم.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setVerticalAlignment(alignment)

اضبط المحاذاة العمودية (من الأعلى إلى الأسفل) للنطاق المحدّد (من الأعلى/الوسط/الأسفل).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

المَعلمات

الاسمالنوعالوصف
alignmentStringالمحاذاة، سواء كانت 'top' أو 'middle' أو 'bottom'، وتؤدي قيمة null إلى إعادة ضبط المحاذاة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setVerticalAlignments(alignments)

تُستخدم شبكة مستطيلة للمحاذاة العمودية (يجب أن تتطابق مع الأبعاد لهذا النطاق).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

المَعلمات

الاسمالنوعالوصف
alignmentsObject[][]هي مصفوفة من البُعدَين للمحاذاة، إما 'top' أو 'middle' أو 'bottom'، أو تعيد ضبط قيمة null المحاذاة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

يمكن أيضًا مراجعة


setVerticalText(isVertical)

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

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setWrap(isWrapEnabled)

اضبط التفاف الخلية للنطاق المحدّد.

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setWrapStrategies(strategies)

تحدّد شبكة مستطيلة لاستراتيجيات الالتفاف.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

المَعلمات

الاسمالنوعالوصف
strategiesWrapStrategy[][]استراتيجيات التغليف المطلوبة.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setWrapStrategy(strategy)

تضبط استراتيجية التفاف النص للخلايا في النطاق.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

المَعلمات

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

setWraps(isWrapEnabled)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

المَعلمات

الاسمالنوعالوصف
isWrapEnabledObject[][]مصفوفة ثنائية الأبعاد من متغيّرات الالتفاف التي تحدّد ما إذا كان يتم التفاف النص في خلية أم لا.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

يمكن أيضًا مراجعة


shiftColumnGroupDepth(delta)

تغيّر عمق تجميع الأعمدة للنطاق حسب القيمة المحددة.

ويؤثر ذلك في إنشاء مجموعات أو تعديلها أو حذفها والتي تتداخل مع النطاق. بالنسبة إلى قيم دلتا إيجابية، يتم إنشاء المجموعات و/أو تعديلها، وبالنسبة إلى الدلتا السلبية، يتم تدمير المجموعات و/أو تعديلها.

ليس لذلك أي تأثير عند تقليل عمق المجموعة إلى أقل من صفر أو أكثر من ثمانية.

إذا كانت column group control position هي BEFORE، يؤدي ذلك إلى ظهور خطأ عند محاولة تغيير عمق الصف الأول.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

المَعلمات

الاسمالنوعالوصف
deltaIntegerالمبلغ الذي تريد استخدامه لتغيير عمق مجموعة الأعمدة لهذا النطاق.

رحلة العودة

Range: هذا النطاق للسلسلة.

رمي

Error: عند محاولة تغيير عمق العمود الأول عندما يكون موضع التحكّم هو GroupControlTogglePosition.BEFORE

التفويض

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

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

shiftRowGroupDepth(delta)

تغيّر عمق تجميع الصفوف للنطاق حسب المبلغ المحدّد.

ويؤثر ذلك في إنشاء مجموعات أو تعديلها أو حذفها والتي تتداخل مع النطاق. بالنسبة إلى قيم دلتا إيجابية، يتم إنشاء المجموعات و/أو تعديلها، وبالنسبة إلى الدلتا السلبية، يتم تدمير المجموعات و/أو تعديلها.

ليس لذلك أي تأثير عند تقليل عمق المجموعة إلى أقل من صفر أو أكثر من ثمانية.

إذا كانت قيمة row group control position هي BEFORE، سيؤدي ذلك إلى ظهور خطأ عند محاولة تغيير عمق الصف الأول.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

المَعلمات

الاسمالنوعالوصف
deltaIntegerالمبلغ المطلوب لتغيير عمق مجموعة الصفوف لهذا النطاق.

رحلة العودة

Range: هذا النطاق للسلسلة.

رمي

Error: عند محاولة تغيير عمق الصف الأول عندما يكون موضع التحكّم هو GroupControlTogglePosition.BEFORE

التفويض

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

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

sort(sortSpecObj)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

المَعلمات

الاسمالنوعالوصف
sortSpecObjObjectالأعمدة التي سيتم الترتيب حسبها.

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

splitTextToColumns()

لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى محدِّد تم اكتشافه تلقائيًا.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

التفويض

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

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

splitTextToColumns(delimiter)

لتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحدَّدة كمُحدِّد مخصَّص.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

المَعلمات

الاسمالنوعالوصف
delimiterStringالمُحدِّد المخصَّص للتقسيم عليه.

التفويض

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

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

splitTextToColumns(delimiter)

لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى المُحدِّد المحدد.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

المَعلمات

الاسمالنوعالوصف
delimiterTextToColumnsDelimiterالمُحدِّد المُعد مسبقًا للتقسيم عليه.

التفويض

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

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

range.trimWhitespace();

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

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

  • 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 range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

رحلة العودة

Range: هذا النطاق للسلسلة.

التفويض

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

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

طرق متوقّفة نهائيًا