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لعرض DeveloperMetadataFinderApi للعثور على البيانات الوصفية لمطور البرامج داخل نطاق هذا النطاق.
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لعرض ما إذا كانت جميع الخلايا في النطاق لها حالة مربع الاختيار كـ 'checked'.
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لضبط الخلفية على اللون المحدّد باستخدام قيم أحمر أخضر أزرق (عدد صحيح بين 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تعمل هذه السياسة على ضبط مجموعة الخطوط، مثلاً "##;quot;quot;&&;;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 المحدّدة على خلية واحدة، وإلا سيتم تطبيق استثناء.

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

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

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

Range — هذا النطاق للسلاسل.

التفويض

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

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

addDeveloperMetadata(key)

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

المعلّمات

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

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

Range — هذا النطاق للسلاسل.

التفويض

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

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

addDeveloperMetadata(key, visibility)

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

المعلّمات

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

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

Range — هذا النطاق للسلاسل.

التفويض

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

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

addDeveloperMetadata(key, value)

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

المعلّمات

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

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

Range — هذا النطاق للسلاسل.

التفويض

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

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

addDeveloperMetadata(key, value, visibility)

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

المعلّمات

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

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

Range — هذا النطاق للسلاسل.

التفويض

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

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

applyColumnBanding()

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

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

Banding: الفرقة الموسيقية الجديدة.

التفويض

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

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

applyColumnBanding(bandingTheme)

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

المعلّمات

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

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

Banding: الفرقة الموسيقية الجديدة.

التفويض

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

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

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

المعلّمات

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

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

وعلاوةً على ذلك، فإن استدعاء هذه الدالة في نطاق يعادل اختيار نطاق والنقر على رمز التنسيق -> دمج -&gt؛ إلغاء الدمج.

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

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()

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

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

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 المحدّد الثابتة في الخلية الأولى في هذا النطاق.

المعلّمات

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

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

PivotTablePivotTable الجديد.

التفويض

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

  • 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()

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

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

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. تضع القيمة المعروضة في الاعتبار تنسيق الوقت والتاريخ وتنسيق العملة، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد لغة جدول البيانات. تؤدي الخلايا الفارغة إلى عرض سلسلة.

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

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()

الحصول على تنسيق الرقم أو التاريخ للخلية أعلى اليمين من النطاق المحدد. ويتم وصف أنماط التنسيق المعروضة في مستندات API في "جداول بيانات 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 إذا لم تكن قيمة الخلية نصًا.

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

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

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

التفويض

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

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

getRichTextValues()

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

// Get 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++) {
    Logger.log(values[i][j]);
  }
}

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

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

التفويض

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

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

getRow()

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

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()

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

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()

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

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

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 بناءً على قيمة الخلية. تعرض الخلايا الفارغة سلسلة فارغة.

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

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()

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

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

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

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

Booleantrue إذا كان النطاق فارغًا، false وإلا.

التفويض

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

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

isChecked()

لعرض ما إذا كانت جميع الخلايا في النطاق لها حالة مربع الاختيار كـ 'checked'. عرض 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.

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

Booleantrue إذا كانت نهاية النطاق مرتبطة بعمود معين، أو 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.

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

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.

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

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

التفويض

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

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

isStartRowBounded()

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

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

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)

لضبط الخلفية على اللون المحدّد باستخدام قيم أحمر أخضر أزرق (عدد صحيح بين 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)

لتحديد شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). ومن أمثلتها عائلات الخطوط هي: "&&;;;;&&;;;&;;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)

تعمل هذه السياسة على ضبط مجموعة الخطوط، مثلاً "##;quot;quot;&&;;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)

تحدّد شبكة مستطيلة من ترجيح الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). ومن الأمثلة على سمك الخط: "bold;bold".

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)

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

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)

تحدّد شبكة مستطيلة للأرقام أو تنسيقات التواريخ (يجب أن تتطابق مع أبعاد هذا النطاق). والقيم هي سلاسل نمط التنسيق كما هو موضح في مستندات واجهة برمجة تطبيقات جداول البيانات.

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

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

المعلّمات

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

الطرق التي تم إيقافها نهائيًا