الوصول إلى نطاقات جداول البيانات وتعديلها يمكن أن يكون النطاق خلية واحدة في ورقة أو مجموعة من الخلايا المجاورة في ورقة.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
activate() | Range | لضبط النطاق المحدد على أنه active range ، مع الخلية
أعلى اليسار في النطاق كـ current cell . |
activateAsCurrentCell() | Range | لضبط الخلية المحددة على أنها current cell . |
addDeveloperMetadata(key) | Range | تتم إضافة البيانات الوصفية لمطوّر البرامج مع المفتاح المحدد إلى النطاق. |
addDeveloperMetadata(key, visibility) | Range | تضيف البيانات الوصفية لمطوّر البرامج مع المفتاح المحدَّد ومستوى الرؤية للنطاق. |
addDeveloperMetadata(key, value) | Range | تضيف البيانات الوصفية لمطوّر البرامج مع المفتاح والقيمة المحدّدين إلى النطاق. |
addDeveloperMetadata(key, value, visibility) | Range | يضيف البيانات الوصفية لمطوّر البرامج مع المفتاح والقيمة وإمكانية الوصول المحدّدة إلى النطاق. |
applyColumnBanding() | Banding | تطبِّق هذه السياسة مظهرًا تلقائيًا لتوزّع الأعمدة على النطاق. |
applyColumnBanding(bandingTheme) | Banding | يطبِّق هذا الإعداد مظهرًا محددًا لتباين الأعمدة على النطاق. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | يطبق مظهر تباين أعمدة محدد على النطاق بإعدادات رأس وتذييل محددة. |
applyRowBanding() | Banding | يُطبِّق مظهرًا تلقائيًا لتعدد الصفوف على النطاق. |
applyRowBanding(bandingTheme) | Banding | يُطبِّق مظهرًا معيّنًا لتعدد الصفوف على النطاق. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | يتم تطبيق مظهر محدد لتعدد الصفوف على النطاق مع إعدادات رأس وتذييل محددة. |
autoFill(destination, series) | void | يملأ destinationRange بالبيانات استنادًا إلى البيانات في هذا النطاق. |
autoFillToNeighbor(series) | void | تحسب نطاقًا لملئه بالبيانات الجديدة استنادًا إلى الخلايا المجاورة ويملأ هذا النطاق تلقائيًا بقيم جديدة استنادًا إلى البيانات التي يتضمنها هذا النطاق. |
breakApart() | Range | قسّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى. |
canEdit() | Boolean | تحدد ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق. |
check() | Range | تغيير حالة مربّعات الاختيار في النطاق إلى "تم اختيارها" |
clear() | Range | محو نطاق المحتوى والتنسيقات. |
clear(options) | Range | محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقّق من صحة البيانات و/أو التعليقات، على النحو المحدّد في الخيارات المتقدّمة المحدّدة |
clearContent() | Range | يمحو محتوى النطاق، مع إبقاء التنسيق كما هو. |
clearDataValidations() | Range | يمحو قواعد التحقق من صحة البيانات للنطاق. |
clearFormat() | Range | يمحو تنسيق هذا النطاق. |
clearNote() | Range | يؤدي هذا الإجراء إلى محو الملاحظة في الخلية أو الخلايا المحدّدة. |
collapseGroups() | Range | تصغير كل المجموعات المضمنة بالكامل في النطاق. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع المحدد. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع المحدد. |
copyTo(destination) | void | تنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyTo(destination, copyPasteType, transposed) | void | تنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyTo(destination, options) | void | تنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع المحدد. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع المحدد. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | تنشئ جدولاً محوريًا فارغًا لمصدر البيانات من مصدر البيانات، ويتم تثبيته في الخلية الأولى في هذا النطاق. |
createDataSourceTable(dataSource) | DataSourceTable | تنشئ جدول مصدر بيانات فارغًا من مصدر البيانات، ويتم تثبيته في الخلية الأولى في هذا النطاق. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | تعرض واجهة برمجة التطبيقات DeveloperMetadataFinderApi للعثور على البيانات الوصفية للمطوّرين ضمن نطاق هذا النطاق. |
createFilter() | Filter | ينشئ فلترًا ويطبقه على النطاق المحدد في ورقة البيانات. |
createPivotTable(sourceData) | PivotTable | تنشئ جدولاً محوريًا فارغًا من sourceData المحددة التي تم إرساؤها في الخلية الأولى
في هذا النطاق. |
createTextFinder(findText) | TextFinder | تنشئ هذه الأداة أداة بحث عن النصوص للنطاق، يمكنها العثور على النص في هذا النطاق واستبداله. |
deleteCells(shiftDimension) | void | يؤدي إلى حذف هذا النطاق من الخلايا. |
expandGroups() | Range | لتوسيع المجموعات المصغّرة التي يتقاطع نطاقها أو مفتاح التحكّم فيها مع هذا النطاق |
getA1Notation() | String | لعرض وصف سلسلة للنطاق، بتدوين A1. |
getBackground() | String | لعرض لون خلفية الخلية العلوية على اليسار في النطاق (على سبيل المثال، '#ffffff' ). |
getBackgroundObject() | Color | لعرض لون خلفية الخلية العلوية على اليسار في النطاق. |
getBackgroundObjects() | Color[][] | لعرض ألوان خلفية الخلايا في النطاق. |
getBackgrounds() | String[][] | تعرض ألوان خلفية الخلايا في النطاق (على سبيل المثال، '#ffffff' ). |
getBandings() | Banding[] | تعرض جميع النطاقات التي تم تطبيقها على أي خلايا في هذا النطاق. |
getCell(row, column) | Range | لعرض خلية معينة في نطاق. |
getColumn() | Integer | تعرض موضع عمود البداية لهذا النطاق. |
getDataRegion() | Range | تعرض نسخة من النطاق تم توسيعه في Direction الأساسية الأربعة لتغطية جميع الخلايا
المجاورة التي تحتوي على بيانات. |
getDataRegion(dimension) | Range | تعرض نسخة من النطاق الموسّع Direction.UP وDirection.DOWN إذا كان البُعد المحدَّد هو Dimension.ROWS ، أو Direction.NEXT وDirection.PREVIOUS إذا كان البُعد Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | تعرض DataSourceFormula للخلية الأولى في النطاق، أو null إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات. |
getDataSourceFormulas() | DataSourceFormula[] | لعرض DataSourceFormula للخلايا في النطاق. |
getDataSourcePivotTables() | DataSourcePivotTable[] | للحصول على جميع الجداول المحورية لمصدر البيانات المتقاطعة مع النطاق. |
getDataSourceTables() | DataSourceTable[] | للحصول على جميع جداول مصدر البيانات المتقاطعة مع النطاق. |
getDataSourceUrl() | String | تعرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء رسوم بيانية واستعلامات. |
getDataTable() | DataTable | عرض البيانات داخل هذا الكائن كـ 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 | لضبط الخلفية على اللون المحدّد باستخدام قيم نموذج أحمر أخضر أزرق (الأعداد الصحيحة بين 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 | تعيين مجموعة الخطوط، مثل "Arial" أو "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()
يُطبِّق مظهرًا تلقائيًا لتعدد الصفوف على النطاق. بشكل افتراضي، يتضمن التباين لون رأس الصفحة وليس تذييلها.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, 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 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
رحلة العودة
Banding
— التباين.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
يُطبِّق مظهرًا معيّنًا لتعدد الصفوف على النطاق. بشكل افتراضي، يتضمن التباين لون رأس الصفحة وليس تذييلها.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, 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 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر لون ليتم تطبيقه على الصفوف في النطاق. |
رحلة العودة
Banding
— النطاق الجديد
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
يتم تطبيق مظهر محدد لتعدد الصفوف على النطاق مع إعدادات رأس وتذييل محددة.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, 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 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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()
قسّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.
يعادل استدعاء هذه الدالة في نطاق تحديد نطاق والنقر على تنسيق > دمج الخلايا > إلغاء الدمج.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, 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 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
رحلة العودة
Range
: هذا النطاق للتسلسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
تحدد ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق. مالك جدول البيانات دائمًا قادر على تحرير النطاقات والأوراق المحمية.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, 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 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.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:G7 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()
تعرض واجهة برمجة التطبيقات DeveloperMetadataFinderApi للعثور على البيانات الوصفية للمطوّرين ضمن نطاق هذا النطاق. ولا تكون بيانات التعريف ضمن نطاق النطاق إلا إذا كانت مضمّنة بالكامل في هذا النطاق. على سبيل المثال، البيانات الوصفية المرتبطة بالصف "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 = textFinder.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
إذا كانت الخلية لا تحتوي على صيغة مصدر بيانات.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
رحلة العودة
DataSourceFormula
: DataSourceFormula
للخلية
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
لعرض DataSourceFormula
للخلايا في النطاق.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
رحلة العودة
DataSourceFormula[]
: مصفوفة من DataSourceFormula
.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
للحصول على جميع الجداول المحورية لمصدر البيانات المتقاطعة مع النطاق.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
رحلة العودة
DataSourcePivotTable[]
: قائمة بالجداول المحورية لمصدر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
للحصول على جميع جداول مصدر البيانات المتقاطعة مع النطاق.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
رحلة العودة
DataSourceTable[]
: قائمة بجداول مصدر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
تعرض عنوان URL للبيانات في هذا النطاق، والذي يمكن استخدامه لإنشاء رسوم بيانية واستعلامات.
موقع Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
رحلة العودة
String
: عنوان URL لهذا النطاق كمصدر بيانات يمكن تمريره إلى واجهات برمجة التطبيقات الأخرى، مثل الرسوم البيانية.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
عرض البيانات داخل هذا الكائن كـ DataTable.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
رحلة العودة
DataTable
- البيانات كجدول بيانات.
getDataTable(firstRowIsHeader)
عرض البيانات داخل هذا النطاق في صورة جدول بيانات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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()
الحصول على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق
// 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 metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
رحلة العودة
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()
تعرض تنسيقات الأرقام أو التاريخ للخلايا في النطاق. يتم توضيح أنماط التنسيق المعروض في وثائق Sheets API.
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()
تعرض موضع الصف لهذا النطاق. يماثل getROWIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
رحلة العودة
Integer
— موضع صف النطاق.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
تعرض موضع الصف لهذا النطاق. يتطابق مع getROW().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
رحلة العودة
Integer
— موضع صف النطاق.
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
يمكن أيضًا مراجعة
getSheet()
لعرض الورقة التي ينتمي إليها هذا النطاق.
// 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)
لضبط الخلفية على اللون المحدّد باستخدام قيم نموذج أحمر أخضر أزرق (الأعداد الصحيحة بين 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 | يشير ذلك إلى القيمة الحمراء في تدوين نموذج أحمر أخضر أزرق. |
green | Integer | القيمة الخضراء في تدوين نموذج أحمر أخضر أزرق. |
blue | Integer | القيمة الزرقاء في تدوين نموذج أحمر أخضر أزرق. |
رحلة العودة
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)
ضبط شبكة مستطيلة من مجموعات الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). ومن أمثلة مجموعات الخطوط "Arial" أو "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)
تعيين مجموعة الخطوط، مثل "Arial" أو "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