الوصول إلى نطاقات جداول البيانات وتعديلها يمكن أن يكون النطاق خلية واحدة في ورقة بيانات أو مجموعة من الخلايا المجاورة في ورقة بيانات.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
activate() | Range | لضبط النطاق المحدّد على أنه active range ، مع
الخلية اليسرى في النطاق كـ current cell . |
activateAsCurrentCell() | Range | لضبط الخلية المحدّدة على أنها current cell . |
addDeveloperMetadata(key) | Range | لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى النطاق. |
addDeveloperMetadata(key, visibility) | Range | لإضافة بيانات وصفية لمطوّر البرامج مع المفتاح المحدد ومستوى الرؤية إلى النطاق. |
addDeveloperMetadata(key, value) | Range | لإضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدد والقيمة إلى النطاق |
addDeveloperMetadata(key, value, visibility) | Range | لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة وإمكانية الوصول إلى النطاق المحدد. |
applyColumnBanding() | Banding | يتم تطبيق مظهر ربط الأعمدة التلقائي على النطاق. |
applyColumnBanding(bandingTheme) | Banding | يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق من خلال إعدادات العنوان والتذييل المحدّدة. |
applyRowBanding() | Banding | تطبيق مظهر ربط الصف التلقائي على النطاق |
applyRowBanding(bandingTheme) | Banding | تطبيق مظهر ربط صف محدد على النطاق. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | يتم تطبيق مظهر تباين الصفوف المحدّد على النطاق مع ضبط الرؤوس والتذييلات المحدّدة. |
autoFill(destination, series) | void | تملأ destinationRange بالبيانات استنادًا إلى البيانات في هذا النطاق. |
autoFillToNeighbor(series) | void | تحسب نطاقًا لتعبئة البيانات الجديدة بناءً على الخلايا المجاورة وملء هذا النطاق تلقائيًا بقيم جديدة استنادًا إلى البيانات المضمّنة في هذا النطاق. |
breakApart() | Range | قسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى. |
canEdit() | Boolean | تحديد ما إذا كان لدى المستخدم الإذن لتعديل كل خلية في النطاق. |
check() | Range | تغيير حالة مربّعات الاختيار في النطاق إلى "تم وضع علامة في المربّع". |
clear() | Range | محو نطاق المحتوى والتنسيقات |
clear(options) | Range | يؤدي إلى محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقّق من صحة البيانات و/أو التعليقات، كما هو محدّد بالخيارات المتقدّمة المحددة. |
clearContent() | Range | يمحو محتوى النطاق، مع ترك التنسيق بدون تغيير. |
clearDataValidations() | Range | محو قواعد التحقّق من صحة البيانات للنطاق |
clearFormat() | Range | محو التنسيق لهذا النطاق |
clearNote() | Range | يؤدي إلى محو الملاحظة في الخلية أو الخلايا المحددة. |
collapseGroups() | Range | تصغير جميع المجموعات المضمّنة بالكامل ضمن النطاق |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع الجغرافي المحدّد. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع الجغرافي المحدّد. |
copyTo(destination) | void | نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا |
copyTo(destination, copyPasteType, transposed) | void | نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا |
copyTo(destination, options) | void | نسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع المحدّد. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع المحدّد. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | ينشئ جدولاً محوريًا لمصدر بيانات فارغًا من مصدر البيانات، ويكون مرتبطًا بالخلية الأولى في هذا النطاق. |
createDataSourceTable(dataSource) | DataSourceTable | ينشئ جدولاً فارغًا لمصدر البيانات من مصدر البيانات، ثابتًا في الخلية الأولى في هذا النطاق. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | تعرض قيمة وصفية البيانات الوصفية لمطوّر البرامج للعثور على البيانات الوصفية لمطوّر البرامج داخل نطاق هذا النطاق. |
createFilter() | Filter | تنشئ فلترًا ويطبّقه على النطاق المحدّد في ورقة البيانات. |
createPivotTable(sourceData) | PivotTable | تنشئ هذه السياسة جدولاً محوريًا فارغًا من sourceData المحدّد الذي تم إرساؤه في الخلية الأولى في هذا النطاق. |
createTextFinder(findText) | TextFinder | تنشئ هذه الميزة نصًا للبحث عن النطاق، ويمكنها العثور على النص واستبداله في هذا النطاق. |
deleteCells(shiftDimension) | void | حذف هذا النطاق من الخلايا. |
expandGroups() | Range | يؤدي هذا الخيار إلى توسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكّم فيها مع هذا النطاق. |
getA1Notation() | String | لعرض وصف سلسلة للنطاق، بتدوين A1. |
getBackground() | String | تعرض لون خلفية الخلية العلوية اليسرى في النطاق (مثلاً، '#ffffff' ). |
getBackgroundObject() | Color | لعرض لون خلفية الخلية العلوية اليسرى في النطاق. |
getBackgroundObjects() | Color[][] | لعرض ألوان خلفية الخلايا في النطاق. |
getBackgrounds() | String[][] | تعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff' ). |
getBandings() | Banding[] | تعرض جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق. |
getCell(row, column) | Range | لعرض خلية معيّنة ضمن نطاق. |
getColumn() | Integer | عرض موضع عمود البدء لهذا النطاق. |
getDataRegion() | Range | تعرض نسخة من النطاق الموسّع في العناصر الأساسية Direction الرئيسية لتغطية جميع الخلايا المجاورة التي تحتوي على بيانات. |
getDataRegion(dimension) | Range | تعرض نسخة من النطاق الموسّع Direction.UP وDirection.DOWN إذا كانت السمة المحدّدة هي Dimension.ROWS ، أو Direction.NEXT وDirection.PREVIOUS إذا كانت السمة Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | تعرض DataSourceFormula للخلية الأولى في النطاق، أو null إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات. |
getDataSourceFormulas() | DataSourceFormula[] | تعرض DataSourceFormula للخلايا في النطاق. |
getDataSourcePivotTables() | DataSourcePivotTable[] | الحصول على جميع الجداول المحورية لمصدر البيانات التي تتداخل مع النطاق |
getDataSourceTables() | DataSourceTable[] | للحصول على جميع جداول مصادر البيانات التي تتقاطع مع النطاق. |
getDataSourceUrl() | String | عرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء الرسوم البيانية وطلبات البحث. |
getDataTable() | DataTable | اعرض البيانات داخل هذا الكائن كجدول بيانات. |
getDataTable(firstRowIsHeader) | DataTable | ويمكنك عرض البيانات داخل هذا النطاق كجدول بيانات. |
getDataValidation() | DataValidation | تعرض قاعدة التحقق من صحة البيانات للخلية أعلى اليمين في النطاق. |
getDataValidations() | DataValidation[][] | تعرض قواعد التحقّق من صحة البيانات لجميع الخلايا في النطاق. |
getDeveloperMetadata() | DeveloperMetadata[] | الحصول على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق |
getDisplayValue() | String | تعرض القيمة المعروضة للخلية أعلى اليمين في النطاق. |
getDisplayValues() | String[][] | لعرض شبكة القيم المستطيلة لهذا النطاق. |
getFilter() | Filter | تعرض الفلتر في ورقة البيانات التي ينتمي إليها هذا النطاق، أو null في حال عدم توفّر فلتر في ورقة البيانات. |
getFontColorObject() | Color | لعرض لون خط الخلية في أعلى يمين النطاق. |
getFontColorObjects() | Color[][] | تعرض ألوان الخط للخلايا في النطاق. |
getFontFamilies() | String[][] | لعرض مجموعات الخطوط للخلايا في النطاق. |
getFontFamily() | String | تعرض مجموعة الخطوط للخلية في أعلى يمين النطاق. |
getFontLine() | String | يعرض نمط الخط للخلية في أعلى يمين النطاق ('underline' أو 'line-through' أو 'none' ). |
getFontLines() | String[][] | للحصول على نمط الخط للخلايا في النطاق ('underline' أو 'line-through' أو
'none' ). |
getFontSize() | Integer | لعرض حجم الخط بحجم النقطة للخلية في أعلى يمين النطاق. |
getFontSizes() | Integer[][] | تعرض أحجام الخط للخلايا في النطاق. |
getFontStyle() | String | لعرض نمط الخط ('italic' أو 'normal' ) للخلية في أعلى يمين النطاق. |
getFontStyles() | String[][] | لعرض أنماط الخط للخلايا في النطاق. |
getFontWeight() | String | لعرض وزن الخط (عادي/غامق) للخلية في أعلى يمين النطاق. |
getFontWeights() | String[][] | لعرض أوزان الخط للخلايا في النطاق. |
getFormula() | String | لعرض الصيغة (تدوين A1) للخلية أعلى يمين النطاق، أو سلسلة فارغة إذا كانت الخلية فارغة أو لا تحتوي على صيغة. |
getFormulaR1C1() | String | تعرض الصيغة (تدوين R1C1) لخلية معينة، أو null إذا لم تكن موجودة. |
getFormulas() | String[][] | لعرض الصيغ (تدوين A1) للخلايا في النطاق. |
getFormulasR1C1() | String[][] | تعرض الصيغ (تدوين R1C1) للخلايا في النطاق. |
getGridId() | Integer | تعرض رقم تعريف الشبكة لورقة البيانات الرئيسية للنطاق. |
getHeight() | Integer | تعرض ارتفاع النطاق. |
getHorizontalAlignment() | String | لعرض المحاذاة الأفقية للنص (يسار/وسم/يمين) للخلية في أعلى يمين النطاق. |
getHorizontalAlignments() | String[][] | تعرض المحاذاة الأفقية للخلايا في النطاق. |
getLastColumn() | Integer | لعرض موضع عمود النهاية. |
getLastRow() | Integer | لعرض موضع صف النهاية. |
getMergedRanges() | Range[] | تعرض صفيفًا من Range كائنات تمثّل خلايا مدمَجة تكون بالكامل داخل النطاق الحالي أو تحتوي على خلية واحدة على الأقل في النطاق الحالي. |
getNextDataCell(direction) | Range | بدءًا من الخلية في العمود والصف الأول من النطاق، تعرض الخلية التالية في الاتجاه المحدّد الذي يمثل حافة نطاق متجاور من الخلايا يحتوي على بيانات داخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه. |
getNote() | String | لعرض الملاحظة المرتبطة بالنطاق المحدد. |
getNotes() | String[][] | لعرض الملاحظات المرتبطة بالخلايا في النطاق. |
getNumColumns() | Integer | لعرض عدد الأعمدة في هذا النطاق. |
getNumRows() | Integer | لعرض عدد الصفوف في هذا النطاق. |
getNumberFormat() | String | الحصول على تنسيق الرقم أو التاريخ للخلية أعلى يمين النطاق المحدد. |
getNumberFormats() | String[][] | لعرض تنسيقات التاريخ أو الأرقام للخلايا في النطاق. |
getRichTextValue() | RichTextValue | تعرض قيمة النص المنسق للخلية أعلى يمين النطاق، أو null إذا لم تكن قيمة الخلية نصًا. |
getRichTextValues() | RichTextValue[][] | تعرض قيم النص المنسّق للخلايا في النطاق. |
getRow() | Integer | لعرض موضع الصف لهذا النطاق. |
getRowIndex() | Integer | لعرض موضع الصف لهذا النطاق. |
getSheet() | Sheet | تعرض ورقة البيانات التي ينتمي إليها هذا النطاق. |
getTextDirection() | TextDirection | لعرض اتجاه النص للخلية اليمنى العليا من النطاق. |
getTextDirections() | TextDirection[][] | لعرض اتجاهات النص للخلايا في النطاق. |
getTextRotation() | TextRotation | لعرض إعدادات تدوير النص للخلية اليمنى العليا من النطاق. |
getTextRotations() | TextRotation[][] | لعرض إعدادات تدوير النص للخلايا في النطاق. |
getTextStyle() | TextStyle | لعرض نمط النص للخلية العلوية اليمنى من النطاق. |
getTextStyles() | TextStyle[][] | لعرض أنماط النص للخلايا في النطاق. |
getValue() | Object | لعرض قيمة الخلية في أعلى يمين النطاق. |
getValues() | Object[][] | لعرض شبكة القيم المستطيلة لهذا النطاق. |
getVerticalAlignment() | String | تعرض المحاذاة العمودية (أعلى/الوسط/الأسفل) للخلية في أعلى يمين النطاق. |
getVerticalAlignments() | String[][] | تعرض المحاذاة العمودية للخلايا في النطاق. |
getWidth() | Integer | لعرض عرض النطاق في الأعمدة. |
getWrap() | Boolean | لعرض ما إذا كان النص في لفّة الخلية. |
getWrapStrategies() | WrapStrategy[][] | لعرض استراتيجيات التفاف النص للخلايا في النطاق. |
getWrapStrategy() | WrapStrategy | لعرض استراتيجية التفاف النص للخلية اليمنى العليا من النطاق. |
getWraps() | Boolean[][] | لعرض ما إذا كان النص في التفاف الخلايا. |
insertCells(shiftDimension) | Range | إدخال خلايا فارغة في هذا النطاق |
insertCheckboxes() | Range | إدراج مربّعات اختيار في كل خلية في النطاق، مع ضبط true للمربّعات المحددة
وfalse لإزالة العلامة منها. |
insertCheckboxes(checkedValue) | Range | إدراج مربعات اختيار في كل خلية في النطاق، مع ضبط قيمة مخصّصة للمربّعات المحددة والسلسلة الفارغة لإزالة العلامة من المربّع. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | إدراج مربعات اختيار في كل خلية في النطاق، مع ضبط القيم المخصصة للحالات التي تم وضع علامة فيها وغير محدّدة. |
isBlank() | Boolean | تعرض true إذا كان النطاق فارغًا تمامًا. |
isChecked() | Boolean | لعرض ما إذا كانت جميع الخلايا في النطاق بالحالة "تم وضع علامة فيها" أم لا. |
isEndColumnBounded() | Boolean | تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. |
isEndRowBounded() | Boolean | تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بصف معيّن. |
isPartOfMerge() | Boolean | لعرض true إذا كانت الخلايا في النطاق الحالي تتداخل مع أي خلايا مدمجة. |
isStartColumnBounded() | Boolean | تحدّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بعمود معيّن. |
isStartRowBounded() | Boolean | تحدِّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بصف معيّن. |
merge() | Range | تدمج الخلايا في النطاق معًا في وحدة واحدة. |
mergeAcross() | Range | ادمج الخلايا في النطاق في أعمدة النطاق. |
mergeVertically() | Range | تدمج الخلايا في النطاق معًا. |
moveTo(target) | void | قص ولصق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق الهدف. |
offset(rowOffset, columnOffset) | Range | تعرض نطاقًا جديدًا تتم إزالته من هذا النطاق من خلال عدد الصفوف والأعمدة المحدّد (الذي يمكن أن يكون سالبًا). |
offset(rowOffset, columnOffset, numRows) | Range | تعرض نطاقًا جديدًا بالنسبة إلى النطاق الحالي، حيث تتم إزاحة النقطة العلوية اليسرى من النطاق الحالي بالصفوف والأعمدة المعيّنة، والارتفاع المحدد في الخلايا. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | تعرض نطاقًا جديدًا بالنسبة إلى النطاق الحالي، حيث تتم إزاحة النقطة العلوية اليسرى من النطاق الحالي بالصفوف والأعمدة المعيّنة، بالارتفاع والعرض المحددَين في الخلايا. |
protect() | Protection | تنشئ عنصرًا يمكن أن يحمي النطاق من تعديله باستثناء المستخدمين الذين لديهم إذن. |
randomize() | Range | الترتيب العشوائي للصفوف في النطاق المحدّد |
removeCheckboxes() | Range | تزيل جميع مربّعات الاختيار من النطاق. |
removeDuplicates() | Range | يزيل الصفوف ضمن هذا النطاق الذي يتضمن قيمًا مكررة للقيم في أي صف سابق. |
removeDuplicates(columnsToCompare) | Range | تزيل صفوفًا ضمن هذا النطاق الذي يتضمن قيمًا من الأعمدة المحددة مكررة من القيم التي يمثلها أي صف سابق. |
setBackground(color) | Range | لضبط لون خلفية جميع الخلايا في النطاق في تدوين CSS (مثل '#ffffff'
أو 'white' ). |
setBackgroundObject(color) | Range | ضبط لون الخلفية لجميع الخلايا في النطاق |
setBackgroundObjects(color) | Range | لضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق). |
setBackgroundRGB(red, green, blue) | Range | لضبط الخلفية على اللون المعنيّ باستخدام قيم RGB (العدد الصحيح بين 0 و255 شاملاً). |
setBackgrounds(color) | Range | لضبط شبكة مستطيلة لألوان الخلفية (يجب أن تتطابق مع سمات هذا النطاق). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | ضبط موقع الحدود |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | لضبط سمة الحدود مع اللون و/أو النمط. |
setDataValidation(rule) | Range | لضبط قاعدة واحدة للتحقق من صحة البيانات لجميع الخلايا في النطاق. |
setDataValidations(rules) | Range | ضبط قواعد التحقق من البيانات لجميع الخلايا في النطاق. |
setFontColor(color) | Range | لضبط لون الخط في تدوين CSS (مثل '#ffffff' أو 'white' ). |
setFontColorObject(color) | Range | لضبط لون الخط للنطاق المحدّد. |
setFontColorObjects(colors) | Range | تُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق). |
setFontColors(colors) | Range | تُستخدم شبكة مستطيلة لألوان الخطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق). |
setFontFamilies(fontFamilies) | Range | تُستخدم شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setFontFamily(fontFamily) | Range | ضبط مجموعة الخطوط، مثل "xxx" أو "Helvetica". |
setFontLine(fontLine) | Range | لضبط نمط خط الخط للنطاق المحدَّد ('underline' أو 'line-through' أو
'none' ). |
setFontLines(fontLines) | Range | تضبط شبكة مستطيلة بأنماط خطوط (يجب أن تتطابق مع سمات هذا النطاق). |
setFontSize(size) | Range | لضبط حجم الخط، بحيث يكون الحجم بحجم النقطة المطلوب استخدامه |
setFontSizes(sizes) | Range | لتحديد شبكة مستطيلة بأحجام خطوط (يجب أن تكون مطابقة لأبعاد هذا النطاق). |
setFontStyle(fontStyle) | Range | يمكنك ضبط نمط الخط للنطاق المحدَّد ('italic' أو 'normal' ). |
setFontStyles(fontStyles) | Range | تُستخدم شبكة مستطيلة لأنماط الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setFontWeight(fontWeight) | Range | ضبط كثافة الخط للنطاق المحدَّد (عادي/غامق) |
setFontWeights(fontWeights) | Range | لإعداد شبكة مستطيلة بأوزان الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setFormula(formula) | Range | تُعدِّل الصيغة لهذا النطاق. |
setFormulaR1C1(formula) | Range | تُعدِّل الصيغة لهذا النطاق. |
setFormulas(formulas) | Range | تضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق). |
setFormulasR1C1(formulas) | Range | تضبط شبكة مستطيلة من الصِيَغ (يجب أن تتطابق مع سمات هذا النطاق). |
setHorizontalAlignment(alignment) | Range | اضبط المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المحدَّد (يسارًا/وسطًا/يمينًا). |
setHorizontalAlignments(alignments) | Range | تضبط شبكة مستطيلة للمحاذاة الأفقية. |
setNote(note) | Range | لضبط الملاحظة على القيمة المحدّدة. |
setNotes(notes) | Range | تُستخدم شبكة مستطيلة للملاحظات (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setNumberFormat(numberFormat) | Range | لضبط تنسيق الرقم أو التاريخ على سلسلة التنسيق المحددة. |
setNumberFormats(numberFormats) | Range | تحدّد شبكة مستطيلة بتنسيقات الأرقام أو التواريخ (يجب أن تتطابق مع سمات هذا النطاق). |
setRichTextValue(value) | Range | لضبط قيمة النص المنسق للخلايا في النطاق |
setRichTextValues(values) | Range | تضبط شبكة مستطيلة من قيم النص المنسّق. |
setShowHyperlink(showHyperlink) | Range | تحدد ما إذا كان يجب أن يعرض النطاق روابط تشعّبية أم لا. |
setTextDirection(direction) | Range | لضبط اتجاه النص للخلايا في النطاق. |
setTextDirections(directions) | Range | تُستخدم شبكة مستطيلة للاتجاهات النصية. |
setTextRotation(degrees) | Range | لضبط إعدادات تدوير النص للخلايا في النطاق. |
setTextRotation(rotation) | Range | لضبط إعدادات تدوير النص للخلايا في النطاق. |
setTextRotations(rotations) | Range | تُستخدم شبكة مستطيلة لتدوير النصوص. |
setTextStyle(style) | Range | لضبط نمط النص للخلايا في النطاق. |
setTextStyles(styles) | Range | تضبط شبكة مستطيلة من أنماط النص. |
setValue(value) | Range | تحدّد قيمة النطاق. |
setValues(values) | Range | تُستخدم شبكة مستطيلة من القيم (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setVerticalAlignment(alignment) | Range | اضبط المحاذاة العمودية (من الأعلى إلى الأسفل) للنطاق المحدّد (من الأعلى/الوسط/الأسفل). |
setVerticalAlignments(alignments) | Range | تُستخدم شبكة مستطيلة للمحاذاة العمودية (يجب أن تتطابق مع الأبعاد لهذا النطاق). |
setVerticalText(isVertical) | Range | لتحديد ما إذا كان سيتم تكديس النص للخلايا في النطاق أم لا. |
setWrap(isWrapEnabled) | Range | اضبط التفاف الخلية للنطاق المحدّد. |
setWrapStrategies(strategies) | Range | تحدّد شبكة مستطيلة لاستراتيجيات الالتفاف. |
setWrapStrategy(strategy) | Range | تضبط استراتيجية التفاف النص للخلايا في النطاق. |
setWraps(isWrapEnabled) | Range | تحدِّد شبكة مستطيلة لسياسات التفاف الكلمات (يجب أن تتطابق مع سمات هذا النطاق). |
shiftColumnGroupDepth(delta) | Range | تغيّر عمق تجميع الأعمدة للنطاق حسب القيمة المحددة. |
shiftRowGroupDepth(delta) | Range | تغيّر عمق تجميع الصفوف للنطاق حسب المبلغ المحدّد. |
sort(sortSpecObj) | Range | يتم ترتيب الخلايا في النطاق المحدّد حسب العمود والترتيب المحدّد. |
splitTextToColumns() | void | لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى محدِّد تم اكتشافه تلقائيًا. |
splitTextToColumns(delimiter) | void | لتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحدَّدة كمُحدِّد مخصَّص. |
splitTextToColumns(delimiter) | void | لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى المُحدِّد المحدد. |
trimWhitespace() | Range | لقطع مسافة بيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في هذا النطاق. |
uncheck() | Range | تغيير حالة مربّعات الاختيار في النطاق إلى "غير محدد". |
المستندات التفصيلية
activate()
لضبط النطاق المحدّد على أنه active range
، مع
الخلية اليسرى في النطاق كـ current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
رحلة العودة
Range
: هذا النطاق للسلسلة.
activateAsCurrentCell()
لضبط الخلية المحدّدة على أنها current cell
.
إذا كانت الخلية المحدّدة موجودة في نطاق حالي، سيصبح هذا النطاق هو النطاق النشط مع الخلية في الوقت الحالي.
إذا لم تكن الخلية المحددة موجودة في أي نطاق حالي، ستتم إزالة التحديد الحالي وتصبح الخلية الخلية الحالية والنطاق النشط.
ملاحظة: يجب أن تتألّف السمة Range
المحدّدة من خلية واحدة، وإلا سيتم عرض استثناء.
// Gets the first sheet of the spreadsheet. var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. var range = sheet.getRange('B5'); var currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى النطاق.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME' to the developer metadata for row 2. range.addDeveloperMetadata('NAME'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
لإضافة بيانات وصفية لمطوّر البرامج مع المفتاح المحدد ومستوى الرؤية إلى النطاق.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT' // for row 2 on Sheet1. range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | إذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
لإضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدد والقيمة إلى النطاق
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح والقيمة وإمكانية الوصول إلى النطاق المحدد.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to PROJECT for row 2 on the sheet. range.addDeveloperMetadata( 'NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | تمثّل هذه السمة مفتاح البيانات الوصفية الجديدة لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | إذن الوصول إلى البيانات الوصفية الجديدة لمطوّر البرامج. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
يتم تطبيق مظهر ربط الأعمدة التلقائي على النطاق. تتضمن عملية الربط تلقائيًا الرأس واللون بدون تذييل.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies column banding to row 2. const colBanding = range.applyColumnBanding(); // Gets the first banding on the sheet and logs the color of the header column. console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString()); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
رحلة العودة
Banding
— النطاق الجديد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق. يكون السوار تلقائيًا لونًا مختلفًا بدون لون تذييل.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies the INDIGO color banding theme to the columns in row 2. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر اللون الذي سيتم تطبيقه على الأعمدة في النطاق |
رحلة العودة
Banding
— النطاق الجديد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
يتم تطبيق مظهر ربط الأعمدة المحدّد على النطاق من خلال إعدادات العنوان والتذييل المحدّدة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 12-22 on the sheet. const range = sheet.getRange('12:22'); // Applies the BLUE color banding theme to rows 12-22. // Sets the header visibility to false and the footer visibility to true. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true); // Gets the banding color and logs it to the console. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString()); // Gets the header color object and logs it to the console. Returns null because the header // visibility is set to false. console.log(sheet.getBandings()[0].getHeaderColumnColorObject()); // Gets the footer color and logs it to the console. console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر اللون الذي سيتم تطبيقه على الأعمدة في النطاق |
showHeader | Boolean | وإذا تم ضبط true ، يتم تطبيق لون عنوان التصنيف الشامل على العمود
الأول. |
showFooter | Boolean | إذا كانت القيمة 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)
تطبيق مظهر ربط صف محدد على النطاق. تتضمن عملية الربط تلقائيًا الرأس واللون بدون تذييل.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر ملوّن لتطبيقه على الصفوف في النطاق |
رحلة العودة
Banding
— النطاق الجديد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
يتم تطبيق مظهر تباين الصفوف المحدّد على النطاق مع ضبط الرؤوس والتذييلات المحدّدة.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر ملوّن لتطبيقه على الصفوف في النطاق |
showHeader | Boolean | إذا كانت القيمة true ، يتم تطبيق لون عنوان التصنيف الشامل على الصف الأول. |
showFooter | Boolean | إذا تم ضبط 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | النطاق الذي تتم تعبئته تلقائيًا بالقيم يجب أن يحتوي نطاق الوجهة على هذا النطاق ويمدّه في اتجاه واحد فقط (أعلى أو أسفل أو يسار أو يمين). |
series | AutoFillSeries | نوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
series | AutoFillSeries | نوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
قسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.
يعادل استدعاء هذه الدالة في نطاق اختيار نطاق والنقر على تنسيق -> دمج -> إلغاء الدمج.
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
تحديد ما إذا كان لدى المستخدم الإذن لتعديل كل خلية في النطاق. ويمكن لمالك جدول البيانات دائمًا تعديل النطاقات والأوراق المحمية.
رحلة العودة
Boolean
— true
إذا كان لدى المستخدم الإذن لتعديل كل خلية في النطاق. 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});
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
options | Object | عنصر JavaScript يُحدِّد المعلّمات المتقدّمة، كما هو موضّح أدناه. |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
commentsOnly | Boolean | لتحديد ما إذا كنت تريد محو التعليقات فقط. |
contentsOnly | Boolean | ما إذا كنت تريد محو المحتوى فقط. |
formatOnly | Boolean | ما إذا كنت تريد محو التنسيق فقط أم لا، وتجدر الإشارة إلى أنّ محو التنسيق يؤدي أيضًا إلى محو قواعد التحقّق من صحة البيانات. |
validationsOnly | Boolean | ما إذا كان سيتم محو قواعد التحقّق من صحة البيانات فقط. |
skipFilteredRows | Boolean | ما إذا كان يجب تجنّب محو الصفوف التي تمت فلترتها. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
gridId | Integer | رقم التعريف الفريد لجدول البيانات في جدول البيانات، بغض النظر عن الموضع. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البدء للنطاق المستهدف. |
rowEnd | Integer | صف نهاية النطاق المستهدَف. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sheet | Sheet | ورقة البيانات المستهدفة. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البدء للنطاق المستهدف. |
rowEnd | Integer | صف نهاية النطاق المستهدَف. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة. |
copyPasteType | CopyPasteType | هو نوع يحدّد كيفية لصق محتوى النطاق للوجهة. |
transposed | Boolean | ما إذا كان يجب لصق النطاق في اتجاهه المحوّل. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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});
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، لا صلة إلا بموضع الخلية في أعلى يمين الشاشة. |
options | Object | عنصر JavaScript يُحدِّد المعلّمات المتقدّمة، كما هو موضّح أدناه. |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
formatOnly | Boolean | تحدد أنه يجب نسخ التنسيق فقط |
contentsOnly | Boolean | تحدد أنه يجب نسخ المحتوى فقط |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
gridId | Integer | رقم التعريف الفريد لجدول البيانات في جدول البيانات، بغض النظر عن الموضع. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البدء للنطاق المستهدف. |
rowEnd | Integer | صف نهاية النطاق المستهدَف. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sheet | Sheet | ورقة البيانات المستهدفة. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البدء للنطاق المستهدف. |
rowEnd | Integer | صف نهاية النطاق المستهدَف. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dataSource | DataSource | مصدر البيانات لإنشاء الجدول المحوري منه. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dataSource | DataSource | مصدر البيانات لإنشاء الجدول المحوري منه. |
رحلة العودة
DataSourceTable
: جدول مصدر البيانات الذي تم إنشاؤه حديثًا.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
تعرض قيمة وصفية البيانات الوصفية لمطوّر البرامج للعثور على البيانات الوصفية لمطوّر البرامج داخل نطاق هذا النطاق. تقع البيانات الوصفية ضمن النطاق فقط إذا كانت مضمّنة فيه بالكامل. على سبيل المثال، لا تقع البيانات الوصفية المرتبطة بالصف "3:3" ضمن نطاق "A1:D5" ولكنها تقع ضمن النطاق "1:5".
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6. const range = sheet.getRange('A1:C6'); // Creates a developer metadata finder to search for metadata in the scope of this range. const developerMetaDataFinder = range.createDeveloperMetadataFinder(); // Logs information about the developer metadata finder to the console. const developerMetaData = developerMetaDataFinder.find()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
رحلة العودة
DeveloperMetadataFinder
: باحث عن البيانات الوصفية لمطوِّر البرامج للبحث عن البيانات الوصفية ضمن هذا النطاق
createFilter()
تنشئ فلترًا ويطبّقه على النطاق المحدّد في ورقة البيانات. لا يمكنك إنشاء أكثر من
فلتر واحد في ورقة بيانات. للوصول إلى الفلتر وتعديله بعد إنشائه، استخدِم getFilter()
أو Sheet.getFilter()
.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }يمكن استخدام هذه الطريقة لإنشاء فلاتر لأوراق بيانات
Grid
، وهي النوع التلقائي من جداول البيانات.
أوراق البيانات على شكل مربّعات هي أوراق بيانات غير مرتبطة بقاعدة بيانات. لإنشاء أنواع أخرى من الفلاتر،
يُرجى الاطّلاع على ما يلي:
- إنشاء فلتر جدول محوري باستخدام
PivotTable.addFilter(sourceDataColumn, filterCriteria)
- إنشاء فلتر لورقة بيانات مرتبطة بقاعدة بيانات باستخدام
DataSourceSheet.addFilter(columnName, filterCriteria)
- إنشاء فلتر لجدول محوري مرتبط بقاعدة بيانات باستخدام
DataSourcePivotTable.addFilter(columnName, filterCriteria)
رحلة العودة
Filter
— الفلتر الجديد
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
تنشئ هذه السياسة جدولاً محوريًا فارغًا من sourceData
المحدّد الذي تم إرساؤه في الخلية الأولى في هذا النطاق.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 as a range in order to place the pivot table. const range = sheet.getRange('A1'); // Gets the range of the source data for the pivot table. const dataRange = sheet.getRange('E12:G20'); // Creates an empty pivot table from the specified source data. const pivotTable = range.createPivotTable(dataRange); // Logs the values from the pivot table's source data to the console. console.log(pivotTable.getSourceDataRange().getValues());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sourceData | Range | البيانات المطلوب إنشاء الجدول المحوري منها. |
رحلة العودة
PivotTable
: PivotTable
التي تم إنشاؤها حديثًا
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
تنشئ هذه الميزة نصًا للبحث عن النطاق، ويمكنها العثور على النص واستبداله في هذا النطاق.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه. |
رحلة العودة
TextFinder
— TextFinder
للنطاق
deleteCells(shiftDimension)
حذف هذا النطاق من الخلايا. يتم نقل البيانات الحالية في ورقة البيانات بجانب البُعد المقدّم نحو النطاق المحذوف.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
shiftDimension | Dimension | البُعد الذي يتم استخدامه لنقل البيانات الحالية. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
يؤدي هذا الخيار إلى توسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكّم فيها مع هذا النطاق. وموقع مفتاح التحكّم هو الفهرس الذي يظهر فيه مفتاح التحكّم، سواء قبل المجموعة أو بعدها مباشرةً استنادًا إلى الإعدادات. في حال كان هناك أكثر من مجموعة في الموقع الجغرافي نفسه، يتم توسيع المجموعة الضحلة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
لعرض وصف سلسلة للنطاق، بتدوين A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
رحلة العودة
String
: وصف السلسلة للنطاق في تدوين A1.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
تعرض لون خلفية الخلية العلوية اليسرى في النطاق (مثلاً، '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
رحلة العودة
String
: رمز اللون في الخلفية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
لعرض لون خلفية الخلية العلوية اليسرى في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
رحلة العودة
Color
- لون خلفية الخلية العلوية اليسرى في النطاق
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
لعرض ألوان خلفية الخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
رحلة العودة
Color[][]
: مصفوفة ثنائية الأبعاد من ألوان الخلفية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
تعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من رموز الألوان للخلفيات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
تعرض جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (let banding of bandings) { console.log(banding.getSecondRowColor()); }
رحلة العودة
Banding[]
: جميع الأشرطة التي يتم تطبيقها على أي خلايا في هذا النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
لعرض خلية معيّنة ضمن نطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Integer | صف الخلية بالنسبة إلى النطاق. |
column | Integer | عمود الخلية المرتبط بالنطاق. |
رحلة العودة
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());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dimension | Dimension | البُعد الذي يتم استخدامه لتوسيع النطاق |
رحلة العودة
Range
: منطقة بيانات النطاق أو نطاق يغطي كل عمود أو كل صف ممدّد بالنطاق الأصلي.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
تعرض DataSourceFormula
للخلية الأولى في النطاق، أو null
إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات.
رحلة العودة
DataSourceFormula
— DataSourceFormula
للخلية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
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();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
firstRowIsHeader | Boolean | لتحديد ما إذا كنت تريد التعامل مع الصف الأول على أنه عنوان. |
رحلة العودة
DataTable
- البيانات كجدول بيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
تعرض قاعدة التحقق من صحة البيانات للخلية أعلى اليمين في النطاق. إذا لم يتم ضبط التحقق من صحة البيانات
في الخلية، ستعرض هذه الطريقة القيمة null
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
رحلة العودة
DataValidation
: قاعدة التحقُّق من البيانات للخلية العلوية اليمنى في النطاق
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
تعرض قواعد التحقّق من صحة البيانات لجميع الخلايا في النطاق. إذا لم يتم ضبط التحقّق من صحة البيانات في خلية معيّنة، تعرض هذه الطريقة null
لموضع هذه الخلية في المصفوفة.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
رحلة العودة
DataValidation[][]
: مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات المرتبطة بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
الحصول على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق
رحلة العودة
DeveloperMetadata[]
: البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
تعرض القيمة المعروضة للخلية أعلى اليمين في النطاق. القيمة هي String
.
تأخذ القيمة المعروضة في الاعتبار تنسيق التاريخ والوقت وتنسيق العملة، بما في ذلك
التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد لغة جدول البيانات. تعرض الخلايا الفارغة سلسلة فارغة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
رحلة العودة
String
: القيمة المعروضة في هذه الخلية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
لعرض شبكة القيم المستطيلة لهذا النطاق.
تعرض صفيفًا ثنائي الأبعاد للقيم المعروضة، تمت فهرستها حسب الصف، ثم حسب العمود. والقيمتان هي String
عنصر. وتراعي القيمة المعروضة تنسيق التاريخ والوقت
والعملة، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد
جدول البيانات. يتم تمثيل الخلايا الفارغة بسلسلة فارغة في المصفوفة. يُرجى العِلم أنّه عندما يبدأ فهرس النطاق عند 1, 1
، تتم فهرسة مصفوفة JavaScript من [0][0]
.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
رحلة العودة
String[][]
— مصفوفة من الأبعاد ثنائية القيم.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
تعرض الفلتر في ورقة البيانات التي ينتمي إليها هذا النطاق، أو null
في حال عدم توفّر فلتر في ورقة البيانات.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Gets the existing filter on the sheet that the given range belongs to. let filter = range.getFilter();
رحلة العودة
Filter
— الفلتر
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
لعرض لون خط الخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
رحلة العودة
Color
- لون خط الخلية العلوية اليسرى في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
تعرض ألوان الخط للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontColorObjects(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
رحلة العودة
Color[][]
: مصفوفة ثنائية الأبعاد من ألوان الخطوط المرتبطة بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
لعرض مجموعات الخطوط للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontFamilies(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من مجموعات الخطوط المرتبطة بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
تعرض مجموعة الخطوط للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
رحلة العودة
String
- مجموعة الخطوط للخلية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
يعرض نمط الخط للخلية في أعلى يمين النطاق ('underline'
أو 'line-through'
أو 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
رحلة العودة
String
: خط الخط
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
للحصول على نمط الخط للخلايا في النطاق ('underline'
أو 'line-through'
أو
'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontLines(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
— مصفوفة ثنائية الأبعاد من خطوط الخطوط المرتبطة بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
لعرض حجم الخط بحجم النقطة للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
رحلة العودة
Integer
: حجم الخط في حجم النقاط
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
تعرض أحجام الخط للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontSizes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
Integer[][]
— مصفوفة ثنائية الأبعاد من أحجام الخطوط للنص المرتبط بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
لعرض نمط الخط ('italic'
أو 'normal'
) للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
رحلة العودة
String
- نمط خط النص في الخلية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
لعرض أنماط الخط للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontStyles(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من أنماط الخطوط للنص المرتبط بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
لعرض وزن الخط (عادي/غامق) للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
رحلة العودة
String
— كثافة خط النص في الخلية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
لعرض أوزان الخط للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontWeights(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
— مصفوفة ثنائية الأبعاد من أحجام الخطوط للنص المرتبط بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
لعرض الصيغة (تدوين A1) للخلية أعلى يمين النطاق، أو سلسلة فارغة إذا كانت الخلية فارغة أو لا تحتوي على صيغة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 var range = sheet.getRange("B5"); // Logs the calculated value and the formula Logger.log("Calculated value: %s Formula: %s", range.getValue(), range.getFormula());
رحلة العودة
String
— صيغة الخلية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
تعرض الصيغة (تدوين R1C1) لخلية معينة، أو null
إذا لم تكن موجودة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
رحلة العودة
String
— الصيغة بتدوين R1C1.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
لعرض الصيغ (تدوين A1) للخلايا في النطاق. الإدخالات في المصفوفة ثنائية الأبعاد هي سلاسل فارغة للخلايا التي لا تحتوي على صيغة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulas(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
رحلة العودة
String[][]
— مصفوفة ثنائية الأبعاد للصيغ بتنسيق سلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
تعرض الصيغ (تدوين R1C1) للخلايا في النطاق. الإدخالات في المصفوفة الثنائية الأبعاد
null
للخلايا التي لا تحتوي على صيغة.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulasR1C1(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
رحلة العودة
String[][]
— مصفوفة ثنائية الأبعاد للصيغ بتدوين R1C1.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
تعرض رقم تعريف الشبكة لورقة البيانات الرئيسية للنطاق. أرقام التعريف هي قيم صحيحة غير سالبة عشوائية.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getGridId());
رحلة العودة
Integer
: رقم تعريف الشبكة لورقة البيانات الرئيسية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
تعرض ارتفاع النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
رحلة العودة
Integer
: ارتفاع النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
لعرض المحاذاة الأفقية للنص (يسار/وسم/يمين) للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
رحلة العودة
String
— المحاذاة الأفقية للنص في الخلية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
تعرض المحاذاة الأفقية للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getHorizontalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من المحاذاة الأفقية للنص المرتبط بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
لعرض موضع عمود النهاية.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
رحلة العودة
Integer
- موضع عمود نهاية النطاق في جدول البيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
لعرض موضع صف النهاية.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
رحلة العودة
Integer
: موضع صف نهاية النطاق في جدول البيانات
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
تعرض صفيفًا من Range
كائنات تمثّل خلايا مدمَجة تكون بالكامل داخل النطاق الحالي أو تحتوي على خلية واحدة على الأقل في النطاق الحالي.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); var mergedRanges = range.getMergedRanges(); for (var i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
رحلة العودة
Range[]
: مصفوفة من Range
عنصر، تمثل خلايا مدمَجة تتداخل مع النطاق.
getNextDataCell(direction)
بدءًا من الخلية في العمود والصف الأول من النطاق، تعرض الخلية التالية في الاتجاه المحدّد الذي يمثل حافة نطاق متجاور من الخلايا يحتوي على بيانات داخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه. يعادل ذلك كتابة
Ctrl+[arrow key]
في المحرِّر.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("C3:E5"); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
direction | Direction | الاتجاه المطلوب للعثور على خلية حافة منطقة البيانات التالية فيها. |
رحلة العودة
Range
- خلية حافة منطقة البيانات أو الخلية على حافة جدول البيانات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
لعرض الملاحظة المرتبطة بالنطاق المحدد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
رحلة العودة
String
— الملاحظة المرتبطة بالخلية المحددة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
لعرض الملاحظات المرتبطة بالخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getNotes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من الملاحظات المرتبطة بالخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
لعرض عدد الأعمدة في هذا النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
رحلة العودة
Integer
: عدد الأعمدة في هذا النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
لعرض عدد الصفوف في هذا النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
رحلة العودة
Integer
: عدد الصفوف في هذا النطاق
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
الحصول على تنسيق الرقم أو التاريخ للخلية أعلى يمين النطاق المحدد. يتم وصف أنماط التنسيق المعروضة في مستندات واجهات برمجة التطبيقات في جداول بيانات Google.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
رحلة العودة
String
- تنسيق الرقم للخلية العلوية اليمنى من النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
لعرض تنسيقات التاريخ أو الأرقام للخلايا في النطاق. يتم وصف أنماط التنسيق المعروضة في مستندات جداول بيانات واجهة برمجة التطبيقات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
رحلة العودة
String[][]
— مصفوفة ثنائية الأبعاد من تنسيقات الأرقام.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
تعرض قيمة النص المنسق للخلية أعلى يمين النطاق، أو null
إذا لم تكن قيمة الخلية نصًا.
// Gets the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); console.log(richText.getText());
رحلة العودة
RichTextValue
: قيمة النص المنسّق للخلية العلوية اليسرى في النطاق أو null
إذا لم تكن قيمة الخلية نصّاً.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
تعرض قيم النص المنسّق للخلايا في النطاق.
// Gets the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
رحلة العودة
RichTextValue[][]
— مصفوفة ثنائية الأبعاد من قيم النص المنسق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
لعرض موضع الصف لهذا النطاق. يتطابق مع getالصفوفIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
رحلة العودة
Integer
: موضع الصف للنطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
لعرض موضع الصف لهذا النطاق. يتطابق مع getالصفوف().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
رحلة العودة
Integer
: موضع الصف للنطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
يمكن أيضًا مراجعة
getSheet()
تعرض ورقة البيانات التي ينتمي إليها هذا النطاق.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
رحلة العودة
Sheet
: ورقة البيانات التي ينتمي إليها هذا النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
لعرض اتجاه النص للخلية اليمنى العليا من النطاق. تعرض null
إذا تم تحديد اتجاه نص الخلية مع الاكتشاف التلقائي.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
رحلة العودة
TextDirection
— اتجاه النص أعلى الخلية اليسرى في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
لعرض اتجاهات النص للخلايا في النطاق. الإدخالات في المصفوفة الثنائية الأبعاد هي null
للخلايا التي تستخدم الاكتشاف التلقائي.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
رحلة العودة
TextDirection[][]
— مصفوفة ثنائية الأبعاد من الاتجاهات النصية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
لعرض إعدادات تدوير النص للخلية اليمنى العليا من النطاق.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
رحلة العودة
TextRotation
: إعدادات تدوير النص
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
لعرض إعدادات تدوير النص للخلايا في النطاق.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
رحلة العودة
TextRotation[][]
- مصفوفة ثنائية الأبعاد من التدوير النصي المرتبط بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
لعرض نمط النص للخلية العلوية اليمنى من النطاق.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
رحلة العودة
TextStyle
- نمط النص أعلى الخلية اليسرى في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
لعرض أنماط النص للخلايا في النطاق.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
رحلة العودة
TextStyle[][]
— مصفوفة ثنائية الأبعاد من أنماط النص.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
لعرض قيمة الخلية في أعلى يمين النطاق. قد تكون القيمة من النوع Number
أو
Boolean
أو Date
أو String
حسب قيمة الخلية. تعرض الخلايا الفارغة سلسلة فارغة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
رحلة العودة
Object
: القيمة في هذه الخلية
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
لعرض شبكة القيم المستطيلة لهذا النطاق.
تعرض صفيفًا ثنائي الأبعاد من القيم التي تمت فهرستها حسب الصف ثم حسب العمود. قد تكون القيم من النوع Number
أو Boolean
أو Date
أو String
، بناءً على قيمة الخلية. يتم تمثيل الخلايا الفارغة بسلسلة فارغة في المصفوفة. يُرجى العِلم أنّه عند بدء فهرس النطاق من 1, 1
، تتم فهرسة مصفوفة JavaScript من [0][0]
.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);في تطبيقات الويب، لا تكون القيمة
Date
مَعلمة قانونية. يتعذّر على getValues()
عرض البيانات إلى تطبيق ويب إذا كان النطاق يحتوي على خلية تحتوي على القيمة Date
. وبدلاً من ذلك، يمكنك تحويل
جميع القيم التي تم استردادها من ورقة البيانات إلى عنصر JavaScript أساسي متوافق مثل Number
أو Boolean
أو String
.رحلة العودة
Object[][]
— مصفوفة من الأبعاد ثنائية القيم.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
تعرض المحاذاة العمودية (أعلى/الوسط/الأسفل) للخلية في أعلى يمين النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
رحلة العودة
String
— المحاذاة العمودية للنص في الخلية.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
تعرض المحاذاة العمودية للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
رحلة العودة
String[][]
: مصفوفة ثنائية الأبعاد من المحاذاة العمودية للنص المرتبط بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
لعرض عرض النطاق في الأعمدة.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
رحلة العودة
Integer
: عدد الأعمدة في النطاق
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
لعرض ما إذا كان النص في لفّة الخلية. ولوضع استراتيجية أكثر دقة للالتفاف، استخدِم getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
رحلة العودة
Boolean
: ما إذا كان النص في هذه الخلية يلتفّ أم لا.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
لعرض استراتيجيات التفاف النص للخلايا في النطاق.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
رحلة العودة
WrapStrategy[][]
: مصفوفة ثنائية الأبعاد من استراتيجيات التفاف النص.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
لعرض استراتيجية التفاف النص للخلية اليمنى العليا من النطاق.
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
رحلة العودة
WrapStrategy
— استراتيجية التفاف النص للخلية اليمنى العليا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
لعرض ما إذا كان النص في التفاف الخلايا. ولوضع استراتيجية أكثر دقة للالتفاف، استخدِم getWrapStrategies()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
رحلة العودة
Boolean[][]
: مصفوفة ثنائية الأبعاد من المحاذاة العمودية للنص المرتبط بخلايا في النطاق.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
إدخال خلايا فارغة في هذا النطاق تحتفظ الخلايا الجديدة بأي تنسيق موجود في الخلايا التي كانت تشغل هذا النطاق في السابق. يتم نقل البيانات الحالية في ورقة البيانات على طول البُعد المقدّم من النطاق المُدرَج.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
shiftDimension | Dimension | البُعد الذي يتم استخدامه لنقل البيانات الحالية. |
رحلة العودة
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');
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
checkedValue | Object | القيمة المُحدّدة للتحقّق من صحة بيانات مربّع الاختيار. |
رحلة العودة
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');
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
checkedValue | Object | القيمة المُحدّدة للتحقّق من صحة بيانات مربّع الاختيار. |
uncheckedValue | Object | تمثّل هذه السمة القيمة التي لم يتم فحصها للتحقّق من صحة بيانات مربّع الاختيار. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
تعرض true
إذا كان النطاق فارغًا تمامًا.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
رحلة العودة
Boolean
- true
إذا كان النطاق فارغًا، أو false
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
لعرض ما إذا كانت جميع الخلايا في النطاق بالحالة "تم وضع علامة فيها" أم لا. تعرض null
إذا تم التحقق من بعض الخلايا وتم إلغاء تحديد الباقي، أو إذا كانت بعض الخلايا لا تحتوي على مربع اختيار التحقق من البيانات.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
رحلة العودة
Boolean
: true
إذا تم وضع علامة في جميع الخلايا في النطاق، أو false
إذا تم وضع علامة في جميع الخلايا في النطاق، أو null
إذا لم يتم وضع علامة في أي من الخلايا أو لم يكن لديك التحقق من صحة بيانات المربّعات.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10
أو B:B
التي تقتصر على الأعمدة في نهاية النطاق، تعرض هذه الطريقة true
. وبالنسبة إلى النطاقات 3:7
أو A1:5
، التي تقتصر على صفوف معيّنة في نهاية النطاق، تعرض هذه الطريقة false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs it to the // console. console.log(range.isEndColumnBounded());
رحلة العودة
Boolean
- true
إذا كانت نهاية النطاق مرتبطة بعمود معيّن، false
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
تحدّد هذه السياسة ما إذا كانت نهاية النطاق مرتبطة بصف معيّن. على سبيل المثال، بالنسبة إلى
النطاقات A1:B10
أو 3:7
التي تتضمن صفوفًا في نهاية النطاق، تعرض هذه الطريقة true
. وبالنسبة إلى النطاقات B:B
أو A1:C
، التي تقتصر على أعمدة معيّنة في نهاية النطاق، تعرض هذه الطريقة false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it to the console. console.log(range.isEndRowBounded());
رحلة العودة
Boolean
— true
إذا كانت نهاية النطاق ترتبط بصف محدد؛ 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();
رحلة العودة
Boolean
— true
إذا تداخل النطاق مع أي خلايا مدمَجة، وإلا سيتم عرض false
.
isStartColumnBounded()
تحدّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10
أو B:B
التي ترتبط بالأعمدة في بداية النطاق، تعرض هذه الطريقة true
. وبالنسبة إلى النطاق 3:7
، الذي يقتصر على صف فقط في بداية النطاق، تعرض هذه الطريقة false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs it to the // console. console.log(range.isStartColumnBounded());
رحلة العودة
Boolean
— true
إذا كانت بداية النطاق مرتبطة بعمود محدد، false
بخلاف ذلك.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
تحدِّد هذه السياسة ما إذا كانت بداية النطاق مرتبطة بصف معيّن. على سبيل المثال، بالنسبة إلى النطاقات A1:B10
أو 3:7
التي ترتبط بالصفوف في بداية النطاق، تعرض هذه الطريقة true
. وبالنسبة إلى النطاق B:B
، الذي يقتصر على عمود معيّن في بداية النطاق، تعرض هذه الطريقة false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it to the // console. console.log(range.isStartRowBounded());
رحلة العودة
Boolean
— true
إذا كانت بداية النطاق مرتبطة بصف محدد؛ 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"));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
target | Range | نطاق مستهدف لنسخ هذا النطاق، ويكون موضع الخلية في أعلى اليمين ملائمًا. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowOffset | Integer | عدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق. |
columnOffset | Integer | عدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowOffset | Integer | عدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق. |
columnOffset | Integer | عدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق. |
numRows | Integer | الارتفاع في صفوف النطاق الجديد. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rowOffset | Integer | عدد الصفوف المتّجهة للأسفل من الخلية أعلى يسار النطاق، وتمثّل القيم السالبة صفوفًا من الخلية العليا اليسرى للنطاق. |
columnOffset | Integer | عدد الأعمدة من الخلية أعلى يسار النطاق في النطاق الصحيح، وتمثّل القيم السلبية الأعمدة المتبقية من الخلية في أعلى يسار النطاق للنطاق. |
numRows | Integer | الارتفاع في صفوف النطاق الجديد. |
numColumns | Integer | العرض في أعمدة النطاق الجديد. |
رحلة العودة
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]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
columnsToCompare | Integer[] | الأعمدة المطلوب تحليلها بحثًا عن قيم مكرّرة. وفي حال عدم توفير أي أعمدة، يتم تحليل جميع الأعمدة بحثًا عن التكرارات. |
رحلة العودة
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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String | رمز لون في ترميز 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون الخلفية المطلوب ضبطه، ويؤدي قيمة 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | Color[][] | مصفوفة ثنائية الأبعاد من الألوان، إعادة ضبط قيم null للون |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
لضبط الخلفية على اللون المعنيّ باستخدام قيم RGB (العدد الصحيح بين 0 و255 شاملاً).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
red | Integer | القيمة الحمراء بتدوين RGB |
green | Integer | القيمة الخضراء بتدوين RGB |
blue | Integer | القيمة الزرقاء في ترميز 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String[][] | مصفوفة ثنائية الأبعاد من الألوان في تدوين 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
top | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
left | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
bottom | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
right | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
vertical | Boolean | true للحدود العمودية الداخلية، false لبلا، وnull بلا تغيير. |
horizontal | Boolean | true للحدود الأفقية الداخلية، وfalse للعدم، وnull بلا تغيير. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
top | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
left | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
bottom | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
right | Boolean | true بلا حدود، وfalse بلا حدود، وnull بلا تغيير. |
vertical | Boolean | true للحدود العمودية الداخلية، false لبلا، وnull بلا تغيير. |
horizontal | Boolean | true للحدود الأفقية الداخلية، وfalse للعدم، وnull بلا تغيير. |
color | String | لون في تدوين CSS (مثل '#ffffff' أو 'white' )، null للون التلقائي (أسود). |
style | BorderStyle | نمط للحدود، null للنمط التلقائي (متغيّر). |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rule | DataValidation | يجب ضبط قاعدة التحقق من صحة البيانات، أو 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rules | DataValidation[][] | مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات التي يجب ضبطها، حيث تزيل قيم 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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الخط في ترميز 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون الخط المطلوب ضبطه، ويؤدي ضبط قيمة 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
colors | Color[][] | مصفوفة ثنائية الأبعاد من الألوان، إعادة ضبط قيم 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
colors | Object[][] | مصفوفة ثنائية الأبعاد من الألوان في تدوين CSS (مثل '#ffffff' أو 'white' ). تؤدي قيم null إلى إعادة ضبط اللون. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
تُستخدم شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع الأبعاد لهذا النطاق). ومن أمثلة مجموعات الخطوط "Family" أو "Helvetica".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var fonts = [ ["Arial", "Helvetica", "Verdana"], ["Courier New", "Arial", "Helvetica] ]; var cell = sheet.getRange("B2:D3"); cell.setFontFamilies(fonts);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontFamilies | Object[][] | مصفوفة ثنائية الأبعاد من مجموعات الخطوط، حيث تعيد قيم null ضبط مجموعة الخطوط. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
ضبط مجموعة الخطوط، مثل "xxx" أو "Helvetica".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontFamily | String | مجموعة الخطوط المطلوب ضبطها، ويؤدي ضبط قيمة 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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontLine | String | نمط خط الخط، إما '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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontLines | Object[][] | مصفوفة ثنائية الأبعاد لأنماط خط الخط ('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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
size | Integer | حجم الخط في حجم النقاط |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sizes | Object[][] | مصفوفة ثنائية الأبعاد من الأحجام. |
رحلة العودة
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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontStyle | String | نمط الخط، إما '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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontStyles | Object[][] | مصفوفة ثنائية الأبعاد من أنماط الخطوط، إما '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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontWeight | String | ويؤدي كثافة الخط إما 'bold' أو 'normal' إلى إعادة ضبط قيمة الخط بمقدار null . |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
لإعداد شبكة مستطيلة بأوزان الخط (يجب أن تتطابق مع الأبعاد لهذا النطاق). ومن أمثلة سماكة الخط "غامق".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fontWeights | Object[][] | مصفوفة ثنائية الأبعاد من ترجيح الخط، إما '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)");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
formula | String | سلسلة تمثّل الصيغة المراد ضبطها للخلية. |
رحلة العودة
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])");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
formula | String | صيغة سلسلة. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
formulas | String[][] | مصفوفة سلسلة ثنائية الأبعاد من الصيغ. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
formulas | String[][] | مصفوفة ثنائية الأبعاد من الصيغ بتنسيق 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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
alignment | String | المحاذاة، سواء كانت '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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
alignments | Object[][] | مصفوفة ثنائية الأبعاد من المحاذاة، إما '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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
note | String | قيمة الملاحظة التي سيتم ضبطها للنطاق، ويؤدي استخدام قيمة 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)
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
notes | Object[][] | مصفوفة ثنائية الأبعاد من الملاحظات، تزيل قيم null الملاحظة. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
يمكن أيضًا مراجعة
setNumberFormat(numberFormat)
لضبط تنسيق الرقم أو التاريخ على سلسلة التنسيق المحددة. يتم وصف أنماط التنسيق المقبولة في وثائق واجهة برمجة تطبيقات جداول بيانات Google.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
numberFormat | String | سلسلة تنسيق رقم |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
تحدّد شبكة مستطيلة بتنسيقات الأرقام أو التواريخ (يجب أن تتطابق مع سمات هذا النطاق). وتكون القيم هي سلاسل لأنماط التنسيق كما هو موضّح في المستندات المتعلّقة بواجهة برمجة تطبيقات "جداول بيانات Google".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var formats = [ [ "0.000", "0,000,000", "$0.00" ] ]; var range = sheet.getRange("B2:D2"); range.setNumberFormats(formats);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
numberFormats | Object[][] | مصفوفة ثنائية الأبعاد من تنسيقات الأرقام. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
value | RichTextValue | قيمة النص المنسّق المطلوب. |
رحلة العودة
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]]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
values | RichTextValue[][] | قيم النص المنسّق المطلوبة. |
رحلة العودة
Range
: هذا النطاق للسلسلة.
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
تحدد ما إذا كان يجب أن يعرض النطاق روابط تشعّبية أم لا.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
showHyperlink | Boolean | يشير ذلك إلى ما إذا كان سيتم عرض الرابط التشعّبي أم لا. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
direction | TextDirection | اتجاه النص المطلوب، وإذا كان 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());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
directions | TextDirection[][] | الاتجاهات النصية المطلوبة، وإذا كان الاتجاه المحدّد هو 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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
degrees | Integer | الزاوية المطلوبة بين الاتجاه العادي والاتجاه المطلوب. بالنسبة إلى النص من اليسار إلى اليمين، تكون الزوايا الإيجابية في اتجاه عقارب الساعة. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rotation | TextRotation | إعدادات تدوير النص المطلوبة. |
رحلة العودة
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());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rotations | TextRotation[][] | إعدادات تدوير النص المطلوبة. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
style | TextStyle | نمط النص المطلوب. |
رحلة العودة
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]]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
styles | TextStyle[][] | أنماط النص المطلوبة. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
value | Object | قيمة النطاق. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
values | Object[][] | مصفوفة ثنائية الأبعاد من القيم. |
رحلة العودة
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");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
alignment | String | المحاذاة، سواء كانت '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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
alignments | Object[][] | هي مصفوفة من البُعدَين للمحاذاة، إما '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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
isVertical | Boolean | لتحديد ما إذا كنت تريد تكديس النص أم لا. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
isWrapEnabled | Boolean | تحديد ما إذا كان سيتم التفاف النص أم لا. |
رحلة العودة
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());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
strategies | WrapStrategy[][] | استراتيجيات التغليف المطلوبة. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
strategy | WrapStrategy | استراتيجية التغليف المطلوبة |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
isWrapEnabled | Object[][] | مصفوفة ثنائية الأبعاد من متغيّرات الالتفاف التي تحدّد ما إذا كان يتم التفاف النص في خلية أم لا. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
delta | Integer | المبلغ الذي تريد استخدامه لتغيير عمق مجموعة الأعمدة لهذا النطاق. |
رحلة العودة
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);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
delta | Integer | المبلغ المطلوب لتغيير عمق مجموعة الصفوف لهذا النطاق. |
رحلة العودة
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}]);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sortSpecObj | Object | الأعمدة التي سيتم الترتيب حسبها. |
رحلة العودة
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 |
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
delimiter | String | المُحدِّد المخصَّص للتقسيم عليه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 |
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
delimiter | TextToColumnsDelimiter | المُحدِّد المُعد مسبقًا للتقسيم عليه. |
التفويض
إنّ النصوص البرمجية التي تستخدم هذه الطريقة تتطلب تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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