الوصول إلى نطاقات جداول البيانات وتعديلها. يمكن أن يكون النطاق خلية واحدة في ورقة أو مجموعة من الخلايا المجاورة في ورقة.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
activate() | Range | لضبط النطاق المحدّد على أنه active range ، مع تحديد الخلية العلوية اليسرى في النطاق على أنها current cell . |
activateAsCurrentCell() | Range | لضبط الخلية المحددة على أنها current cell . |
addDeveloperMetadata(key) | Range | لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى النطاق. |
addDeveloperMetadata(key, visibility) | Range | تعمل هذه الميزة على إضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدّد وإذن الوصول إلى النطاق. |
addDeveloperMetadata(key, value) | Range | إضافة بيانات وصفية لمطوّر البرامج بالمفتاح والقيمة المحدّدَين إلى النطاق. |
addDeveloperMetadata(key, value, visibility) | Range | يضيف هذا الإعداد البيانات الوصفية لمطوّر البرامج باستخدام المفتاح والقيمة وحق الوصول إلى النطاق المحدّد. |
applyColumnBanding() | Banding | يطبّق مظهر ربط الأعمدة التلقائي على النطاق. |
applyColumnBanding(bandingTheme) | Banding | ينطبق مظهرًا مُحدَّدًا لتباين الأعمدة على النطاق. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | ينطبق مظهرًا مُحدَّدًا لتباين الأعمدة على النطاق المحدّد بإعدادات العناوين والتذييلات المحدّدة. |
applyRowBanding() | Banding | يؤدي هذا الإعداد إلى تطبيق مظهر ربط صف تلقائي على النطاق. |
applyRowBanding(bandingTheme) | Banding | يؤدي إلى تطبيق مظهر ربط صف مُحدَّد على النطاق. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | يُطبِّق مظهر ربط نطاقات مُحدَّد على النطاق من خلال إعدادات رؤوس وتذييلات محدّدة. |
autoFill(destination, series) | void | يملأ destinationRange ببيانات استنادًا إلى البيانات في هذا النطاق. |
autoFillToNeighbor(series) | void | تحسب نطاقًا لملء البيانات الجديدة بناءً على الخلايا المجاورة، ويملأ هذا النطاق تلقائيًا بالقيم الجديدة استنادًا إلى البيانات المتضمّنة في هذا النطاق. |
breakApart() | Range | قسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى. |
canEdit() | Boolean | لتحديد ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق. |
check() | Range | تُغيِّر حالة مربّعات الاختيار في النطاق إلى "تم وضع علامة عليه". |
clear() | Range | يؤدي إلى محو نطاق المحتوى والتنسيقات. |
clear(options) | Range | يؤدي إلى محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقّق من البيانات و/أو التعليقات، كما هو محدّد في الخيارات المتقدّمة المحدّدة. |
clearContent() | Range | ويؤدي ذلك إلى محو محتوى النطاق، مع ترك التنسيق بدون تغيير. |
clearDataValidations() | Range | محو قواعد التحقّق من صحة البيانات للنطاق |
clearFormat() | Range | محو تنسيق هذا النطاق |
clearNote() | Range | محو الملاحظة في الخلية أو الخلايا المحددة |
collapseGroups() | Range | تصغير جميع المجموعات المضمّنة بالكامل في النطاق. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع المحدد. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ تنسيق النطاق إلى الموقع المحدد. |
copyTo(destination) | void | لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyTo(destination, copyPasteType, transposed) | void | لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyTo(destination, options) | void | لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع الجغرافي المحدّد. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | انسخ محتوى النطاق إلى الموقع الجغرافي المحدّد. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | تنشئ جدولاً محوريًا فارغًا لمصدر البيانات من مصدر البيانات، بحيث يكون ثابتًا في الخلية الأولى في هذا النطاق. |
createDataSourceTable(dataSource) | DataSourceTable | تنشئ جدول مصدر بيانات فارغًا من مصدر البيانات، ثابتًا في الخلية الأولى في هذا النطاق. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | لعرض DeveloperMetadataFinderApi للعثور على البيانات الوصفية لمطور البرامج داخل نطاق هذا النطاق. |
createFilter() | Filter | يتم إنشاء فلتر وتطبيقه على النطاق المحدّد في ورقة البيانات. |
createPivotTable(sourceData) | PivotTable | تنشئ جدولاً محوريًا فارغًا من sourceData المحدّد الثابتة في الخلية الأولى في هذا النطاق. |
createTextFinder(findText) | TextFinder | تنشئ أداة البحث عن نص للنطاق، الذي يمكنها العثور على النص في هذا النطاق واستبداله. |
deleteCells(shiftDimension) | void | حذف هذا النطاق من الخلايا. |
expandGroups() | Range | تعمل هذه الميزة على توسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكم فيها مع هذا النطاق. |
getA1Notation() | String | لعرض وصف سلسلة للنطاق، بعلامة A1. |
getBackground() | String | لعرض لون خلفية الخلية في أعلى يمين النطاق في النطاق (على سبيل المثال، '#ffffff' ). |
getBackgroundObject() | Color | لعرض لون خلفية الخلية في أعلى اليمين في النطاق. |
getBackgroundObjects() | Color[][] | لعرض ألوان خلفية الخلايا في النطاق. |
getBackgrounds() | String[][] | لعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff' ). |
getBandings() | Banding[] | لعرض جميع الأشرطة التي تم تطبيقها على أي خلايا في هذا النطاق. |
getCell(row, column) | Range | لعرض خلية معينة داخل نطاق. |
getColumn() | Integer | لعرض موضع عمود البداية لهذا النطاق. |
getDataRegion() | Range | لعرض نسخة من النطاق الموسّع في عناصر Direction الأربعة الأساسية لتغطية جميع
الخلايا المجاورة التي تحتوي على بيانات. |
getDataRegion(dimension) | Range | تعرض نسخة من النطاق الموسّع Direction.UP وDirection.DOWN إذا كان البُعد المحدّد هو Dimension.ROWS ، أو Direction.NEXT وDirection.PREVIOUS إذا كان البُعد هو Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | لعرض DataSourceFormula للخلية الأولى في النطاق أو null إذا لم تحتوي الخلية على صيغة مصدر بيانات. |
getDataSourceFormulas() | DataSourceFormula[] | لعرض DataSourceFormula للخلايا في النطاق. |
getDataSourcePivotTables() | DataSourcePivotTable[] | الحصول على جميع الجداول المحورية لمصدر البيانات المتقاطعة مع النطاق. |
getDataSourceTables() | DataSourceTable[] | الحصول على جميع جداول مصدر البيانات التي تتقاطع مع النطاق. |
getDataSourceUrl() | String | تعرض عنوان URL للبيانات في هذا النطاق الذي يمكن استخدامه لإنشاء الرسوم البيانية وطلبات البحث. |
getDataTable() | DataTable | عرض البيانات داخل هذا الكائن كجدول بيانات. |
getDataTable(firstRowIsHeader) | DataTable | عرض البيانات داخل هذا النطاق في صورة جدول بيانات. |
getDataValidation() | DataValidation | لعرض قاعدة التحقق من البيانات للخلية العلوية اليمنى في النطاق. |
getDataValidations() | DataValidation[][] | لعرض قواعد التحقق من صحة البيانات لكل الخلايا في النطاق. |
getDeveloperMetadata() | DeveloperMetadata[] | احصل على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق. |
getDisplayValue() | String | لعرض القيمة المعروضة للخلية العلوية اليمنى في النطاق. |
getDisplayValues() | String[][] | لعرض الشبكة المستطيلة للقيم لهذا النطاق. |
getFilter() | Filter | لعرض الفلتر في ورقة البيانات التي ينتمي إليها هذا النطاق، أو null في حال عدم توفّر فلتر في ورقة البيانات. |
getFontColorObject() | Color | لعرض لون الخط للخلية في أعلى يمين النطاق. |
getFontColorObjects() | Color[][] | لعرض ألوان الخط للخلايا في النطاق. |
getFontFamilies() | String[][] | لعرض مجموعات خطوط الخلايا التي في النطاق. |
getFontFamily() | String | لعرض مجموعة خطوط الخلية في أعلى يمين النطاق. |
getFontLine() | String | الحصول على نمط السطر للخلية في أعلى يمين النطاق ('underline' أو
'line-through' أو 'none' ). |
getFontLines() | String[][] | للحصول على نمط سطر الخلايا في النطاق ('underline' أو 'line-through' أو
'none' ). |
getFontSize() | Integer | لعرض حجم الخط بحجم النقطة للخلية في أعلى يمين النطاق. |
getFontSizes() | Integer[][] | لعرض أحجام الخطوط للخلايا في النطاق. |
getFontStyle() | String | لعرض نمط الخط ('italic' أو 'normal' ) للخلية في أعلى يمين النطاق. |
getFontStyles() | String[][] | لعرض أنماط الخط للخلايا في النطاق. |
getFontWeight() | String | لعرض حجم الخط (عادي/غامق) للخلية في أعلى يمين النطاق. |
getFontWeights() | String[][] | لعرض قيم عرض خلايا الخلايا في النطاق. |
getFormula() | String | لعرض الصيغة (تدوين A1) للخلية العلوية اليمنى من النطاق أو سلسلة فارغة إذا كانت الخلية فارغة أو لا تحتوي على صيغة. |
getFormulaR1C1() | String | لعرض الصيغة (تدوين R1C1) لخلية معيّنة، أو null إذا لم يتم إدخال أي منها. |
getFormulas() | String[][] | لعرض الصيغ (تدوين A1) للخلايا في النطاق. |
getFormulasR1C1() | String[][] | لعرض الصيغ (تدوين R1C1) للخلايا في النطاق. |
getGridId() | Integer | لعرض معرِّف الشبكة للورقة الرئيسية للنطاق. |
getHeight() | Integer | لعرض ارتفاع النطاق. |
getHorizontalAlignment() | String | لعرض المحاذاة الأفقية للنص (لليسار/الوسط/لليمين) للخلية في أعلى يمين النطاق. |
getHorizontalAlignments() | String[][] | لعرض المحاذاة الأفقية للخلايا في النطاق. |
getLastColumn() | Integer | عرض موضع العمود النهائي |
getLastRow() | Integer | عرض موضع صف النهاية |
getMergedRanges() | Range[] | تعرض صفيفًا لكائنات Range التي تمثل الخلايا المدمجة التي تقع ضمن النطاق الحالي بالكامل أو التي تحتوي على خلية واحدة على الأقل في النطاق الحالي. |
getNextDataCell(direction) | Range | بدءًا من الخلية في العمود الأول وصف الصف، تعرض الخلية التالية في الاتجاه المحدّد وهو حافة نطاق متجاور من الخلايا يتضمن بيانات بداخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه. |
getNote() | String | لعرض الملاحظة المرتبطة بالنطاق المحدد. |
getNotes() | String[][] | لعرض الملاحظات المرتبطة بالخلايا في النطاق. |
getNumColumns() | Integer | لعرض عدد الأعمدة في هذا النطاق. |
getNumRows() | Integer | لعرض عدد الصفوف في هذا النطاق. |
getNumberFormat() | String | الحصول على تنسيق الرقم أو التاريخ للخلية أعلى اليمين من النطاق المحدد. |
getNumberFormats() | String[][] | لعرض تنسيقات الأرقام أو التواريخ للخلايا في النطاق. |
getRichTextValue() | RichTextValue | لعرض قيمة النص المنسق للخلية العلوية اليمنى من النطاق، أو null إذا لم تكن قيمة الخلية نصًا. |
getRichTextValues() | RichTextValue[][] | لعرض قيم النص المنسق للخلايا في النطاق. |
getRow() | Integer | لعرض موضع الصف لهذا النطاق. |
getRowIndex() | Integer | لعرض موضع الصف لهذا النطاق. |
getSheet() | Sheet | تعرض ورقة البيانات التي ينتمي إليها هذا النطاق. |
getTextDirection() | TextDirection | لعرض اتجاه النص للخلية العلوية اليمنى من النطاق. |
getTextDirections() | TextDirection[][] | لعرض اتجاهات النص للخلايا في النطاق. |
getTextRotation() | TextRotation | لعرض إعدادات تدوير النص للخلية العلوية اليمنى من النطاق. |
getTextRotations() | TextRotation[][] | لعرض إعدادات تدوير النص للخلايا في النطاق. |
getTextStyle() | TextStyle | لعرض نمط النص للخلية العلوية اليمنى من النطاق. |
getTextStyles() | TextStyle[][] | لعرض أنماط النص للخلايا في النطاق. |
getValue() | Object | لعرض قيمة الخلية العلوية اليسرى في النطاق. |
getValues() | Object[][] | لعرض الشبكة المستطيلة للقيم لهذا النطاق. |
getVerticalAlignment() | String | لعرض المحاذاة الرأسية (أعلى/وسط/أسفل) الخلية في الزاوية العلوية اليمنى من النطاق. |
getVerticalAlignments() | String[][] | لعرض المحاذاة العمودية للخلايا في النطاق. |
getWidth() | Integer | لعرض عرض النطاق في الأعمدة. |
getWrap() | Boolean | يعرض ما إذا كان النص في التفاف الخلية. |
getWrapStrategies() | WrapStrategy[][] | لعرض استراتيجيات التفاف النص للخلايا في النطاق. |
getWrapStrategy() | WrapStrategy | لعرض استراتيجية التفاف النص للخلية العلوية اليمنى من النطاق. |
getWraps() | Boolean[][] | يعرض ما إذا كان النص في التفاف الخلايا. |
insertCells(shiftDimension) | Range | إدراج خلايا فارغة في هذا النطاق |
insertCheckboxes() | Range | إدراج مربّعات اختيار في كل خلية في النطاق، وضبطها على true لتحديدها وfalse لإلغاء اختيارها. |
insertCheckboxes(checkedValue) | Range | إدراج مربّعات اختيار في كل خلية في النطاق، مع ضبط قيمة مخصّصة للمربّع المحدد والسلسلة الفارغة لإلغاء الاختيار. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | إدراج مربّعات اختيار في كل خلية في النطاق، حيث تم ضبطها باستخدام قيم مخصّصة للحالات المحدّدة وغير المحدّدة. |
isBlank() | Boolean | لعرض true إذا كان النطاق فارغًا تمامًا. |
isChecked() | Boolean | لعرض ما إذا كانت جميع الخلايا في النطاق لها حالة مربع الاختيار كـ 'checked'. |
isEndColumnBounded() | Boolean | تحدِّد ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. |
isEndRowBounded() | Boolean | تحدِّد ما إذا كانت نهاية النطاق مرتبطة بصف معيّن. |
isPartOfMerge() | Boolean | لعرض true إذا كانت الخلايا في النطاق الحالي تتداخل مع أي خلايا مدمجة. |
isStartColumnBounded() | Boolean | تحدِّد ما إذا كانت بداية النطاق مرتبطة بعمود معيّن. |
isStartRowBounded() | Boolean | تحدِّد ما إذا كانت بداية النطاق مرتبطة بصف معيّن. |
merge() | Range | لدمج الخلايا في النطاق معًا في قالب واحد. |
mergeAcross() | Range | ادمج الخلايا في النطاق في أعمدة النطاق. |
mergeVertically() | Range | لدمج الخلايا في النطاق معًا. |
moveTo(target) | void | اقتطِع والصِق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق المستهدَف. |
offset(rowOffset, columnOffset) | Range | تعرض نطاقًا جديدًا تتم إزاحةه من هذا النطاق عن طريق العدد المحدّد من الصفوف والأعمدة (التي يمكن أن تكون سالبة). |
offset(rowOffset, columnOffset, numRows) | Range | تعرض نطاقًا جديدًا نسبيًا للنطاق الحالي، حيث تتم إزاحة النقطة اليسرى العليا من النطاق الحالي حسب الصفوف والأعمدة المحددة، مع الارتفاع المحدّد في الخلايا. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | لعرض نطاق جديد نسبي إلى النطاق الحالي، تتم إزاحة النقطة اليسرى العليا من النطاق الحالي حسب الصفوف والأعمدة المحددة، ومع الارتفاع والعرض في الخلايا. |
protect() | Protection | تنشئ عنصرًا يمكنه حماية النطاق من التعديل باستثناء المستخدمين الذين لديهم إذن. |
randomize() | Range | التوزيع العشوائي للصفوف في النطاق المحدّد. |
removeCheckboxes() | Range | إزالة جميع مربّعات الاختيار من النطاق. |
removeDuplicates() | Range | يزيل الصفوف داخل هذا النطاق الذي يتضمن قيمًا مكرّرة من القيم في أي صف سابق. |
removeDuplicates(columnsToCompare) | Range | لإزالة الصفوف داخل هذا النطاق التي تتضمن قيمًا في الأعمدة المحدّدة والتي تكون تكرارًا للقيم لأي صف سابق. |
setBackground(color) | Range | لضبط لون الخلفية لجميع الخلايا في النطاق في تدوين CSS (مثل '#ffffff'
أو 'white' ). |
setBackgroundObject(color) | Range | لضبط لون الخلفية لجميع الخلايا في النطاق. |
setBackgroundObjects(color) | Range | تحدّد شبكة مستطيلة بألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق). |
setBackgroundRGB(red, green, blue) | Range | لضبط الخلفية على اللون المحدّد باستخدام قيم أحمر أخضر أزرق (عدد صحيح بين 0 و255 شامل). |
setBackgrounds(color) | Range | تحدّد شبكة مستطيلة بألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | لضبط موقع الحدود. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | لضبط خاصية الحدود باستخدام اللون و/أو النمط. |
setDataValidation(rule) | Range | لضبط قاعدة واحدة للتحقق من صحة البيانات في كل الخلايا في النطاق. |
setDataValidations(rules) | Range | لضبط قواعد التحقّق من البيانات لجميع الخلايا في النطاق. |
setFontColor(color) | Range | ضبط لون الخط في تدوين CSS (مثل '#ffffff' أو 'white' ) |
setFontColorObject(color) | Range | لضبط لون الخط للنطاق المحدّد. |
setFontColorObjects(colors) | Range | لتحديد شبكة مستطيلة لألوان الخط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontColors(colors) | Range | لتحديد شبكة مستطيلة لألوان الخط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontFamilies(fontFamilies) | Range | لتحديد شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontFamily(fontFamily) | Range | تعمل هذه السياسة على ضبط مجموعة الخطوط، مثلاً "##;quot;quot;&&;;Helvetica". |
setFontLine(fontLine) | Range | لضبط نمط خط الخط للنطاق المحدّد ('underline' أو 'line-through' أو
'none' ). |
setFontLines(fontLines) | Range | تُحدّد شبكة مستطيلة لأنماط الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontSize(size) | Range | لتحديد حجم الخط، بحيث يكون الحجم هو حجم النقطة المطلوب استخدامه. |
setFontSizes(sizes) | Range | لتحديد شبكة مستطيلة بأحجام الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontStyle(fontStyle) | Range | يمكنك ضبط نمط الخط للنطاق المحدّد ('italic' أو 'normal' ). |
setFontStyles(fontStyles) | Range | لتحديد شبكة مستطيلة لأنماط الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFontWeight(fontWeight) | Range | اضبط عرض الخط للنطاق المحدّد (عادي/غامق). |
setFontWeights(fontWeights) | Range | تحدّد شبكة مستطيلة من ترجيح الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFormula(formula) | Range | يتم تعديل صيغة هذا النطاق. |
setFormulaR1C1(formula) | Range | يتم تعديل صيغة هذا النطاق. |
setFormulas(formulas) | Range | تحدِّد شبكة مستطيلة للصيغ (يجب أن تتطابق مع أبعاد هذا النطاق). |
setFormulasR1C1(formulas) | Range | تحدِّد شبكة مستطيلة للصيغ (يجب أن تتطابق مع أبعاد هذا النطاق). |
setHorizontalAlignment(alignment) | Range | اضبط المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المحدّد (يسار/وسط/يمين). |
setHorizontalAlignments(alignments) | Range | تضبط شبكة مستطيلة للمحاذاة الأفقية. |
setNote(note) | Range | لضبط الملاحظة إلى القيمة المحددة. |
setNotes(notes) | Range | تُحدِّد مجموعة من الملاحظات المستطيلة (يجب أن تتطابق مع أبعاد هذا النطاق). |
setNumberFormat(numberFormat) | Range | لضبط الرقم أو تنسيق التاريخ على سلسلة التنسيق المحددة. |
setNumberFormats(numberFormats) | Range | تحدّد شبكة مستطيلة للأرقام أو تنسيقات التواريخ (يجب أن تتطابق مع أبعاد هذا النطاق). |
setRichTextValue(value) | Range | لضبط قيمة النص المنسق للخلايا في النطاق. |
setRichTextValues(values) | Range | تضبط شبكة مستطيلة لقيم النص المنسق. |
setShowHyperlink(showHyperlink) | Range | لتحديد ما إذا كان يجب أن يعرض النطاق روابط تشعّبية أم لا. |
setTextDirection(direction) | Range | لضبط اتجاه النص للخلايا في النطاق. |
setTextDirections(directions) | Range | تضبط شبكة مستطيلة للاتجاهات النصية. |
setTextRotation(degrees) | Range | لضبط إعدادات تدوير النص للخلايا في النطاق. |
setTextRotation(rotation) | Range | لضبط إعدادات تدوير النص للخلايا في النطاق. |
setTextRotations(rotations) | Range | تحدّد شبكة مستطيلة لتدوير النص. |
setTextStyle(style) | Range | لضبط نمط النص للخلايا في النطاق. |
setTextStyles(styles) | Range | تحدِّد شبكة مستطيلة لأنماط النص. |
setValue(value) | Range | لتحديد قيمة النطاق. |
setValues(values) | Range | تحدّد شبكة من القيم المستطيلة (يجب أن تتطابق مع أبعاد هذا النطاق). |
setVerticalAlignment(alignment) | Range | اضبط المحاذاة الرأسية (من الأعلى إلى الأسفل) للنطاق المحدّد (أعلى/وسط/أسفل). |
setVerticalAlignments(alignments) | Range | يحدد شبكة مستطيلة للمحاذاة الرأسية (يجب أن تتطابق مع أبعاد هذا النطاق). |
setVerticalText(isVertical) | Range | لتحديد ما إذا كان سيتم تكديس النص للخلايا في النطاق أم لا. |
setWrap(isWrapEnabled) | Range | اضبط التفاف الخلية للنطاق المحدّد. |
setWrapStrategies(strategies) | Range | تمثّل هذه السمة شبكة مستطيلة لاستراتيجيات الالتفاف. |
setWrapStrategy(strategy) | Range | لضبط استراتيجية التفاف النص للخلايا في النطاق. |
setWraps(isWrapEnabled) | Range | تُحدّد شبكة مستطيلة لسياسات التفاف الكلمات (يجب أن تتطابق مع أبعاد هذا النطاق). |
shiftColumnGroupDepth(delta) | Range | لتغيير عمق تجميع الأعمدة للنطاق حسب المبلغ المحدّد. |
shiftRowGroupDepth(delta) | Range | لتغيير عمق تجميع الصفوف للنطاق حسب المبلغ المحدّد. |
sort(sortSpecObj) | Range | لترتيب الخلايا في النطاق المحدد حسب العمود ومن تحديد الترتيب. |
splitTextToColumns() | void | لتقسيم عمود إلى نص إلى أعمدة متعددة استنادًا إلى محدِّد تم الكشف عنه تلقائيًا. |
splitTextToColumns(delimiter) | void | لتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحددة كمُحدِّد مخصّص. |
splitTextToColumns(delimiter) | void | لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى المُحدِّد المحدد. |
trimWhitespace() | Range | لقطع المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في هذا النطاق. |
uncheck() | Range | تُغيِّر حالة مربّعات الاختيار في النطاق إلى "غير محدّد". |
المستندات التفصيلية
activate()
لضبط النطاق المحدّد على أنه active range
، مع تحديد الخلية العلوية اليسرى في النطاق على أنها current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
activateAsCurrentCell()
لضبط الخلية المحددة على أنها current cell
.
إذا كانت الخلية المحددة موجودة في نطاق حالي، يصبح هذا النطاق هو النطاق النشط مع الخلية في الخلية الحالية.
إذا لم تكن الخلية المحددة موجودة في أي نطاق حالي، تتم إزالة الاختيار الحالي وتصبح الخلية الخلية الحالية والنطاق النشط.
ملاحظة: يجب أن تحتوي السمة Range
المحدّدة على خلية واحدة، وإلا سيتم تطبيق استثناء.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('B5'); range.activate(); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
لإضافة بيانات وصفية لمطوّر البرامج باستخدام المفتاح المحدد إلى النطاق.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | مفتاح البيانات الوصفية الجديد لمطوّر البرامج. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
تعمل هذه الميزة على إضافة بيانات وصفية لمطوّر البرامج بالمفتاح المحدّد وإذن الوصول إلى النطاق.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | مفتاح البيانات الوصفية الجديد لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | مستوى رؤية البيانات الوصفية الجديدة لمطوّر البرامج. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
إضافة بيانات وصفية لمطوّر البرامج بالمفتاح والقيمة المحدّدَين إلى النطاق.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | مفتاح البيانات الوصفية الجديد لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
يضيف هذا الإعداد البيانات الوصفية لمطوّر البرامج باستخدام المفتاح والقيمة وحق الوصول إلى النطاق المحدّد.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | مفتاح البيانات الوصفية الجديد لمطوّر البرامج. |
value | String | قيمة البيانات الوصفية الجديدة لمطوّر البرامج. |
visibility | DeveloperMetadataVisibility | مستوى رؤية البيانات الوصفية الجديدة لمطوّر البرامج. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
يطبّق مظهر ربط الأعمدة التلقائي على النطاق. يتضمّن السوار تلقائيًا عنوانًا بلا لون تذييل.
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
ينطبق مظهرًا مُحدَّدًا لتباين الأعمدة على النطاق. يكون السوار تلقائيًا بدون لون للتذييل.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر ملوَّن يمكن تطبيقه على الأعمدة في النطاق |
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
ينطبق مظهرًا مُحدَّدًا لتباين الأعمدة على النطاق المحدّد بإعدادات العناوين والتذييلات المحدّدة.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | مظهر ملوَّن يمكن تطبيقه على الأعمدة في النطاق |
showHeader | Boolean | إذا تم استخدام true ، سيتم تطبيق لون رأس المظهر الموحّد على العمود
الأول. |
showFooter | Boolean | إذا تم استخدام true ، يتم تطبيق لون تذييل مظهر الأشرطة على العمود الأخير. |
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
يؤدي هذا الإعداد إلى تطبيق مظهر ربط صف تلقائي على النطاق. يتضمّن السوار تلقائيًا عنوانًا بلا لون تذييل.
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
يؤدي إلى تطبيق مظهر ربط صف مُحدَّد على النطاق. يتضمّن السوار تلقائيًا عنوانًا بلا لون تذييل.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | المظهر الملوَّن المراد تطبيقه على الصفوف في النطاق. |
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
يُطبِّق مظهر ربط نطاقات مُحدَّد على النطاق من خلال إعدادات رؤوس وتذييلات محدّدة.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
bandingTheme | BandingTheme | المظهر الملوَّن المراد تطبيقه على الصفوف في النطاق. |
showHeader | Boolean | إذا تم ضبط السياسة true ، يتم تطبيق لون رأس المظهر الموحّد على الصف الأول. |
showFooter | Boolean | إذا تم تطبيق true ، يتم تطبيق لون تذييل مظهر الأشرطة على الصف الأخير. |
تذكرة ذهاب وعودة
Banding
: الفرقة الموسيقية الجديدة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
يملأ destinationRange
ببيانات استنادًا إلى البيانات في هذا النطاق. يتم أيضًا تحديد القيم الجديدة حسب النوع series
المحدّد. يجب أن يحتوي نطاق الوجهة على هذا النطاق، ويمدّه في اتجاه واحد فقط. على سبيل المثال، تملأ الخيارات التالية A1:A20
بسلسلة من الأرقام المتزايدة استنادًا إلى القيم الحالية في A1:A4
:
var sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. var sourceRange = sheet.getRange("A1:A4"); // The range to fill with values. var destination = sheet.getRange("A1:A20"); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | النطاق الذي يتم ملؤه تلقائيًا بالقيم. ويجب أن يحتوي نطاق الوجهة على هذا النطاق وأن يوسّعه في اتجاه واحد فقط (لأعلى أو لأسفل أو لليسار أو لليمين). |
series | AutoFillSeries | نوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
تحسب نطاقًا لملء البيانات الجديدة بناءً على الخلايا المجاورة، ويملأ هذا النطاق تلقائيًا بالقيم الجديدة استنادًا إلى البيانات المتضمّنة في هذا النطاق. ويتم تحديد هذه القيم الجديدة أيضًا من خلال النوع series
المحدّد.
يراعي نطاق الوجهة الذي تم احتسابه البيانات المحيطة لتحديد الموضع الذي يجب إدراج القيم الجديدة فيه: إذا كانت هناك بيانات على اليسار أو اليمين مباشرةً في عمود يتم ملؤه تلقائيًا، لن تمتد القيم الجديدة إلا إلى هذه البيانات المجاورة.
على سبيل المثال، إذا كانت السمة A1:A20
مملوءة بسلسلة من الأرقام المتزايدة وكانت هذه الطريقة يتم طلبها في النطاق B1:B4
الذي يحتوي على سلسلة من التواريخ، يتم إدراج القيم الجديدة فقط في B5:B20
. بهذه الطريقة، تحدِّد هذه القيم الجديدة "لصق" للخلايا التي تحتوي على قيم في العمود A.
var sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] var sourceRange = sheet.getRange("B1:B4"); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
series | AutoFillSeries | نوع سلسلة الملء التلقائي التي يجب استخدامها لحساب القيم الجديدة. يختلف تأثير هذه السلسلة استنادًا إلى نوع البيانات المصدر ومقدارها. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
قسِّم أي خلايا متعددة الأعمدة في النطاق إلى خلايا فردية مرة أخرى.
وعلاوةً على ذلك، فإن استدعاء هذه الدالة في نطاق يعادل اختيار نطاق والنقر على رمز التنسيق -> دمج ->؛ إلغاء الدمج.
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
لتحديد ما إذا كان المستخدم لديه إذن لتعديل كل خلية في النطاق. ويمكن لمالك جدول البيانات دائمًا تعديل أوراق البيانات والنطاقات المحمية.
تذكرة ذهاب وعودة
Boolean
— true
إذا كان لدى المستخدم إذن بتعديل كل خلية في النطاق. false
وإلا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
تعمل على تغيير حالة مربعات الاختيار في النطاق إلى "تم تحديدها". وتتجاهل الخلايا في النطاق التي لا تحتوي حاليًا على القيمة المحددة أو التي لم يتم التحقق منها.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'checked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
يؤدي إلى محو نطاق المحتوى والتنسيقات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
يؤدي إلى محو نطاق المحتوى و/أو التنسيق و/أو قواعد التحقّق من البيانات و/أو التعليقات، كما هو محدّد في الخيارات المتقدّمة المحدّدة. يتم محو جميع البيانات تلقائيًا.
// The code below clears range C2:G8 in the active sheet, but preserves the format, // data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
options | Object | عنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه. |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
commentsOnly | Boolean | ما إذا كان سيتم محو التعليقات فقط |
contentsOnly | Boolean | ما إذا كان سيتم محو المحتوى فقط. |
formatOnly | Boolean | يمكنك اختيار ما إذا كنت تريد محو التنسيق فقط، وتجدر الإشارة إلى أنّ محو التنسيق يؤدي أيضًا إلى محو قواعد التحقّق من صحة البيانات. |
validationsOnly | Boolean | ما إذا كان سيتم محو قواعد التحقق من البيانات فقط. |
skipFilteredRows | Boolean | ما إذا كان سيتم تجنّب محو الصفوف التي تمت فلترتها. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
ويؤدي ذلك إلى محو محتوى النطاق، مع ترك التنسيق بدون تغيير.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
محو قواعد التحقّق من صحة البيانات للنطاق
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
محو تنسيق هذا النطاق
يؤدي ذلك إلى محو تنسيق النص للخلية أو الخلايا في النطاق، ولكن لا يعيد ضبط أي قواعد تنسيق للأرقام.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
محو الملاحظة في الخلية أو الخلايا المحددة
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
تصغير جميع المجموعات المضمّنة بالكامل في النطاق. إذا لم تكن هناك مجموعة بالكامل داخل النطاق، يتم تصغير المجموعة الأكثر عمقًا التي تقع ضمن النطاق.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
انسخ تنسيق النطاق إلى الموقع المحدد. إذا كانت الوجهة أكبر أو أصغر من نطاق المصدر، يتم تكرار المصدر أو اقتطاعه وفقًا لذلك. يُرجى ملاحظة أنّ هذه الطريقة تنسخ التنسيق فقط.
للحصول على وصف تفصيلي للمعلّمة networkId، اطّلِع على getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
gridId | Integer | المعرّف الفريد للورقة ضمن جدول البيانات، بغض النظر عن الموضع. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البداية للنطاق المستهدف. |
rowEnd | Integer | صف النهاية للنطاق المستهدف. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
راجع أيضًا
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
انسخ تنسيق النطاق إلى الموقع المحدد. إذا كانت الوجهة أكبر أو أصغر من نطاق المصدر، يتم تكرار المصدر أو اقتطاعه وفقًا لذلك. يُرجى ملاحظة أنّ هذه الطريقة تنسخ التنسيق فقط.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sheet | Sheet | ورقة البيانات الهدف. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البداية للنطاق المستهدف. |
rowEnd | Integer | صف النهاية للنطاق المستهدف. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. يتم نسخ كل من القيم والتنسيق.
// The code below copies the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، فقط موضع الخلية في أعلى يمين الصفحة ملائم. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، فقط موضع الخلية في أعلى يمين الصفحة ملائم. |
copyPasteType | CopyPasteType | هو نوع يحدّد كيفية لصق محتوى النطاق في الوجهة. |
transposed | Boolean | ما إذا كان يجب لصق النطاق في اتجاهه المتبادل. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
لنسخ البيانات من نطاق من الخلايا إلى نطاق آخر من الخلايا. يتم نسخ كل من القيم والتنسيق بشكل تلقائي، ولكن يمكن إلغاء ذلك باستخدام الوسيطات المتقدمة.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Range | نطاق وجهة للنسخ إليه، فقط موضع الخلية في أعلى يمين الصفحة ملائم. |
options | Object | عنصر JavaScript يُحدّد المعلمات المتقدمة، كما هو موضّح أدناه. |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
formatOnly | Boolean | تحديد أنه يجب نسخ التنسيق فقط |
contentsOnly | Boolean | تحديد أنه يجب نسخ المحتوى فقط |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
انسخ محتوى النطاق إلى الموقع الجغرافي المحدّد. إذا كانت الوجهة أكبر أو أصغر من نطاق المصدر، يتم تكرار المصدر أو اقتطاعه وفقًا لذلك.
للحصول على وصف تفصيلي للمعلّمة networkId، اطّلِع على getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
gridId | Integer | المعرّف الفريد للورقة ضمن جدول البيانات، بغض النظر عن الموضع. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البداية للنطاق المستهدف. |
rowEnd | Integer | صف النهاية للنطاق المستهدف. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
راجع أيضًا
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
انسخ محتوى النطاق إلى الموقع الجغرافي المحدّد. إذا كانت الوجهة أكبر أو أصغر من نطاق المصدر، يتم تكرار المصدر أو اقتطاعه وفقًا لذلك.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sheet | Sheet | ورقة البيانات الهدف. |
column | Integer | العمود الأول للنطاق المستهدف. |
columnEnd | Integer | عمود النهاية للنطاق المستهدف. |
row | Integer | صف البداية للنطاق المستهدف. |
rowEnd | Integer | صف النهاية للنطاق المستهدف. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
تنشئ جدولاً محوريًا فارغًا لمصدر البيانات من مصدر البيانات، بحيث يكون ثابتًا في الخلية الأولى في هذا النطاق.
يوضح هذا المثال كيفية إنشاء جدول محوري جديد لمصدر البيانات وضبطه.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM); pivotTable.addFilter('dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dataSource | DataSource | مصدر البيانات لإنشاء الجدول المحوري منه. |
تذكرة ذهاب وعودة
DataSourcePivotTable
— الجدول المحوري لمصدر البيانات الذي تم إنشاؤه حديثًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
تنشئ جدول مصدر بيانات فارغًا من مصدر البيانات، ثابتًا في الخلية الأولى في هذا النطاق.
يوضح هذا المثال كيفية إنشاء جدول مصدر بيانات جديد وإعداده.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var dataSourceTable = anchorCell.createDataSourceTable(dataSource); .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', /* ascending= *\/ true) .addSortSpec('dataColumnB', /* ascending= *\/ false);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dataSource | DataSource | مصدر البيانات لإنشاء الجدول المحوري منه. |
تذكرة ذهاب وعودة
DataSourceTable
— جدول مصدر البيانات الذي تم إنشاؤه حديثًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
لعرض DeveloperMetadataFinderApi للعثور على البيانات الوصفية لمطور البرامج داخل نطاق هذا النطاق. وتقع البيانات الوصفية ضمن النطاق إذا كانت مضمّنة بالكامل في ذلك النطاق. على سبيل المثال، لا تقع البيانات الوصفية المرتبطة بالصف "3:3" ضمن نطاق "A1:D5" ولكنها تقع ضمن نطاق "1:5".
تذكرة ذهاب وعودة
DeveloperMetadataFinder
: أداة البحث عن البيانات الوصفية لمطوّر البرامج للبحث عن البيانات الوصفية في نطاق هذا النطاق.
createFilter()
يتم إنشاء فلتر وتطبيقه على النطاق المحدّد في ورقة البيانات. لا يمكنك إنشاء أكثر من
فلتر واحد في جدول بيانات واحد. للوصول إلى الفلتر وتعديله بعد إنشائه، استخدِم getFilter()
أو Sheet.getFilter()
.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }استخدِم هذه الطريقة لإنشاء فلاتر لأوراق بيانات
Grid
، النوع التلقائي من جداول البيانات.
أوراق الشبكة هي أوراق غير مرتبطة بقاعدة بيانات. لإنشاء أنواع أخرى من الفلاتر،
ارجع إلى ما يلي:
- إنشاء فلتر جدول محوري باستخدام
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
المحدّد الثابتة في الخلية الأولى في هذا النطاق.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
sourceData | Range | البيانات المراد إنشاء الجدول المحوري منها. |
تذكرة ذهاب وعودة
PivotTable
— PivotTable
الجديد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
تنشئ أداة البحث عن نص للنطاق، الذي يمكنها العثور على النص في هذا النطاق واستبداله.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه. |
تذكرة ذهاب وعودة
TextFinder
— TextFinder
للنطاق
deleteCells(shiftDimension)
حذف هذا النطاق من الخلايا. يتم نقل البيانات الحالية في ورقة البيانات على طول البُعد المقدّم إلى النطاق المحذوف.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
shiftDimension | Dimension | السمة التي يمكن من خلالها نقل البيانات الحالية. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
تعمل هذه الميزة على توسيع المجموعات المصغّرة التي يتقاطع نطاقها أو عنصر التحكم فيها مع هذا النطاق. وموقع تبديل التحكّم هو الفهرس الذي يظهر فيه مفتاح التحكّم، قبل المجموعة أو بعدها مباشرةً استنادًا إلى الإعدادات. إذا كان هناك أكثر من مجموعة واحدة في الموقع نفسه، يتم توسيع المجموعة الضحلة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
لعرض وصف سلسلة للنطاق، بعلامة A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
تذكرة ذهاب وعودة
String
— وصف السلسلة للنطاق بتنسيق A1.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
لعرض لون خلفية الخلية في أعلى يمين النطاق في النطاق (على سبيل المثال، '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
تذكرة ذهاب وعودة
String
: رمز لون الخلفية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
لعرض لون خلفية الخلية في أعلى اليمين في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
تذكرة ذهاب وعودة
Color
- لون خلفية الخلية العلوية اليسرى في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
لعرض ألوان خلفية الخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
تذكرة ذهاب وعودة
Color[][]
: مصفوفة ثنائية الأبعاد من ألوان الخلفية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
لعرض ألوان خلفية الخلايا في النطاق (مثل '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
تذكرة ذهاب وعودة
String[][]
: مصفوفة ثنائية الأبعاد من رموز الألوان للخلفيات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
لعرض جميع الأشرطة التي تم تطبيقها على أي خلايا في هذا النطاق.
تذكرة ذهاب وعودة
Banding[]
— جميع الأشرطة التي تم تطبيقها على أي خلايا في هذا النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
لعرض خلية معينة داخل نطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Integer | صف الخلية بالنسبة إلى النطاق. |
column | Integer | عمود الخلية بالنسبة إلى النطاق. |
تذكرة ذهاب وعودة
Range
— نطاق يحتوي على خلية واحدة في الإحداثيات المحددة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
لعرض موضع عمود البداية لهذا النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
تذكرة ذهاب وعودة
Integer
— موضع العمود في النطاق الزمني في جدول البيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
لعرض نسخة من النطاق الموسّع في عناصر Direction
الأربعة الأساسية لتغطية جميع
الخلايا المجاورة التي تحتوي على بيانات. إذا كان النطاق محاطًا بخلايا فارغة لا تتضمنها على مستوى خطوط مائلة، يتم عرض النطاق نفسه. يشبه هذا الإجراء اختيار النطاق
وكتابة Ctrl+A
في المحرِّر.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());
تذكرة ذهاب وعودة
Range
— منطقة بيانات النطاق أو نطاق جدول البيانات بأكمله.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
تعرض نسخة من النطاق الموسّع Direction.UP
وDirection.DOWN
إذا كان البُعد المحدّد هو Dimension.ROWS
، أو Direction.NEXT
وDirection.PREVIOUS
إذا كان البُعد هو Dimension.COLUMNS
. يستند توسيع النطاق إلى اكتشاف البيانات بجانب النطاق المنظَّم مثل جدول. يشمل النطاق الموسّع جميع الخلايا المجاورة التي تحتوي على بيانات في البُعد المحدّد، بما في ذلك حدود الجدول. إذا كان النطاق الأصلي محاطًا بخلايا فارغة على طول البُعد المحدد، يتم عرض النطاق نفسه. تشبه هذه الطريقة اختيار النطاق وكتابة
Ctrl+Space
للأعمدة أو Shift+Space
للصفوف في المحرّر.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "C2:C4" Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation()); // Logs "B3:D3" Logger.log( sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
dimension | Dimension | المكوّن الذي سيتم توسيع النطاق خلاله. |
تذكرة ذهاب وعودة
Range
— نطاق بيانات النطاق أو نطاق يغطي كل عمود أو كل صف يمتد إلى النطاق الأصلي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
لعرض DataSourceFormula
للخلية الأولى في النطاق أو null
إذا لم تحتوي الخلية على صيغة مصدر بيانات.
تذكرة ذهاب وعودة
DataSourceFormula
— DataSourceFormula
للخلية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
لعرض DataSourceFormula
للخلايا في النطاق.
تذكرة ذهاب وعودة
DataSourceFormula[]
: مصفوفة من DataSourceFormula
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
الحصول على جميع الجداول المحورية لمصدر البيانات المتقاطعة مع النطاق.
تذكرة ذهاب وعودة
DataSourcePivotTable[]
— قائمة بالجداول المحورية لمصدر البيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
الحصول على جميع جداول مصدر البيانات التي تتقاطع مع النطاق.
تذكرة ذهاب وعودة
DataSourceTable[]
— قائمة بجداول مصادر البيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
تعرض عنوان URL للبيانات في هذا النطاق الذي يمكن استخدامه لإنشاء الرسوم البيانية وطلبات البحث.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
تذكرة ذهاب وعودة
String
: عنوان URL لهذا النطاق كمصدر بيانات يمكن تمريره إلى واجهات برمجة التطبيقات الأخرى، مثل الرسوم البيانية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
getDataTable(firstRowIsHeader)
عرض البيانات داخل هذا النطاق في صورة جدول بيانات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
firstRowIsHeader | Boolean | لتحديد ما إذا كنت تريد التعامل مع الصف الأول كعنوان. |
تذكرة ذهاب وعودة
DataTable
: البيانات في شكل جدول بيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
لعرض قاعدة التحقق من البيانات للخلية العلوية اليمنى في النطاق. إذا لم يتم إعداد التحقق من صحة البيانات على الخلية، ستعرض هذه الطريقة null
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
تذكرة ذهاب وعودة
DataValidation
- قاعدة التحقّق من صحة البيانات للخلية العلوية اليمنى في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
لعرض قواعد التحقق من صحة البيانات لكل الخلايا في النطاق. إذا لم يتم إعداد التحقّق من صحة البيانات
على خلية معيّنة، ستعرض هذه الطريقة null
لموضع هذه الخلية في المصفوفة.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
تذكرة ذهاب وعودة
DataValidation[][]
: مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات مرتبطة بالخلايا في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
احصل على البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق.
تذكرة ذهاب وعودة
DeveloperMetadata[]
: البيانات الوصفية لمطوّر البرامج المرتبطة بهذا النطاق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
لعرض القيمة المعروضة للخلية العلوية اليمنى في النطاق. القيمة هي String
.
تضع القيمة المعروضة في الاعتبار تنسيق الوقت والتاريخ وتنسيق العملة، بما في ذلك التنسيقات التي يتم تطبيقها تلقائيًا من خلال إعداد لغة جدول البيانات. تؤدي الخلايا الفارغة إلى عرض سلسلة.
تذكرة ذهاب وعودة
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()
الحصول على تنسيق الرقم أو التاريخ للخلية أعلى اليمين من النطاق المحدد. ويتم وصف أنماط التنسيق المعروضة في مستندات API في "جداول بيانات Google".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
تذكرة ذهاب وعودة
String
— تنسيق الرقم للخلية العلوية اليمنى من النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
لعرض تنسيقات الأرقام أو التواريخ للخلايا في النطاق. وقد تم وصف أنماط التنسيق المعروضة في مستندات واجهة برمجة تطبيقات جداول البيانات.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
تذكرة ذهاب وعودة
String[][]
— مصفوفة ثنائية الأبعاد من تنسيقات الأرقام.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
لعرض قيمة النص المنسق للخلية العلوية اليمنى من النطاق، أو null
إذا لم تكن قيمة الخلية نصًا.
// Get the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); Logger.log(richText);
تذكرة ذهاب وعودة
RichTextValue
: قيمة النص المنسّق للخلية العلوية اليمنى في النطاق، أو null
إذا لم تكن قيمة الخلية نصًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
لعرض قيم النص المنسق للخلايا في النطاق.
// Get the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { Logger.log(values[i][j]); } }
تذكرة ذهاب وعودة
RichTextValue[][]
— مصفوفة ثنائية الأبعاد من قيم النص المنسّق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
لعرض موضع الصف لهذا النطاق. متطابق مع getRowIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
تذكرة ذهاب وعودة
Integer
- موضع صف النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
لعرض موضع الصف لهذا النطاق. متطابقة مع getRow().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
تذكرة ذهاب وعودة
Integer
- موضع صف النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
راجع أيضًا
getSheet()
تعرض ورقة البيانات التي ينتمي إليها هذا النطاق.
تذكرة ذهاب وعودة
Sheet
- ورقة البيانات التي ينتمي إليها هذا النطاق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
لعرض اتجاه النص للخلية العلوية اليمنى من النطاق. تعرض null
إذا تم تحديد اتجاه نص الخلية مع الاكتشاف التلقائي.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
تذكرة ذهاب وعودة
TextDirection
— اتجاه النص أعلى الخلية اليسرى في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
لعرض اتجاهات النص للخلايا في النطاق. الإدخالات في المصفوفة الثنائية الأبعاد هي null
للخلايا التي تستخدم الاكتشاف التلقائي.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
تذكرة ذهاب وعودة
TextDirection[][]
— مصفوفة ثنائية الاتجاه من الاتجاهات النصية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
لعرض إعدادات تدوير النص للخلية العلوية اليمنى من النطاق.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
تذكرة ذهاب وعودة
TextRotation
— إعدادات تدوير النص.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
لعرض إعدادات تدوير النص للخلايا في النطاق.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
تذكرة ذهاب وعودة
TextRotation[][]
— مصفوفة ثنائية الأبعاد من عمليات تناوب النصوص المرتبطة بخلايا في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
لعرض نمط النص للخلية العلوية اليمنى من النطاق.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
تذكرة ذهاب وعودة
TextStyle
— نمط النص للخلية العلوية اليمنى في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
لعرض أنماط النص للخلايا في النطاق.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
تذكرة ذهاب وعودة
TextStyle[][]
— مصفوفة ثنائية الأبعاد من أنماط النص.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
لعرض قيمة الخلية العلوية اليسرى في النطاق. قد تكون القيمة من النوع Number
أو
Boolean
أو Date
أو String
بناءً على قيمة الخلية. تعرض الخلايا الفارغة سلسلة فارغة.
تذكرة ذهاب وعودة
Object
— القيمة في هذه الخلية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
لعرض الشبكة المستطيلة للقيم لهذا النطاق.
تعرض صفيفًا ثنائي الأبعاد من القيم، وتمت فهرسته حسب الصف، ثم حسب العمود. وقد تكون القيم من النوع Number
أو Boolean
أو Date
أو String
، بناءً على قيمة الخلية. ويتم تمثيل الخلايا الفارغة بسلسلة فارغة في المصفوفة. تذكّر أنّه على الرغم من أنّ فهرس النطاق يبدأ بـ 1, 1
، تتم فهرسة مصفوفة JavaScript من [0][0]
.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);في تطبيقات الويب، لا تمثّل القيمة
Date
مَعلمة قانونية. فشل getValues()
في عرض بيانات إلى تطبيق ويب إذا كان النطاق يحتوي على خلية تحتوي على قيمة Date
. وبدلاً من ذلك، يمكنك تحويل
جميع القيم التي تم استردادها من جدول البيانات إلى أولوية JavaScript متوافقة، مثل Number
أو Boolean
أو String
.تذكرة ذهاب وعودة
Object[][]
— مصفوفة من قيم ثنائية الأبعاد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
لعرض المحاذاة الرأسية (أعلى/وسط/أسفل) الخلية في الزاوية العلوية اليمنى من النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
تذكرة ذهاب وعودة
String
— محاذاة رأسية للنص في الخلية.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
لعرض المحاذاة العمودية للخلايا في النطاق.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
تذكرة ذهاب وعودة
String[][]
: مصفوفة ثنائية الأبعاد من محاذاة النص الرأسية مع الخلايا في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
لعرض عرض النطاق في الأعمدة.
تذكرة ذهاب وعودة
Integer
— عدد الأعمدة في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
يعرض ما إذا كان النص في التفاف الخلية. وللحصول على استراتيجية التفاف أكثر دقة، استخدِم getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
تذكرة ذهاب وعودة
Boolean
: تحديد ما إذا كان النص في هذه الخلية يتم التفافه أم لا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
لعرض استراتيجيات التفاف النص للخلايا في النطاق.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
تذكرة ذهاب وعودة
WrapStrategy[][]
: مصفوفة ثنائية الأبعاد من استراتيجيات التفاف النص.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
لعرض استراتيجية التفاف النص للخلية العلوية اليمنى من النطاق.
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
تذكرة ذهاب وعودة
WrapStrategy
— استراتيجية التفاف النص للخلية العلوية اليمنى في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
يعرض ما إذا كان النص في التفاف الخلايا. وللحصول على استراتيجية التفاف أكثر دقة، استخدِم getWrapStrategies()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
تذكرة ذهاب وعودة
Boolean[][]
: مصفوفة ثنائية الأبعاد من محاذاة النص الرأسية مع الخلايا في النطاق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
إدراج خلايا فارغة في هذا النطاق تحتفظ الخلايا الجديدة بأي تنسيق متوفّر في الخلايا التي كانت تشغّل هذا النطاق في السابق. يتم نقل البيانات الحالية في ورقة البيانات على طول البُعد المقدّم بعيدًا عن النطاق المُدرَج.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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()
لعرض ما إذا كانت جميع الخلايا في النطاق لها حالة مربع الاختيار كـ 'checked'. عرض null
إذا تم التحقق من بعض الخلايا ولم يتم وضع علامة في بقية الخلايا، أو في حال لم يتم وضع علامة في مربّع الاختيار لبعض الخلايا.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
تذكرة ذهاب وعودة
Boolean
- true
، إذا تم وضع علامة على جميع الخلايا في النطاق، أو false
إذا تم وضع علامة في جميع الخلايا في النطاق، أو null
إذا تمت إزالة العلامة من أي من الخلايا أو لم يتم وضع علامة في مربع اختيار التحقق من صحة البيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
تحدِّد ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى
النطاقات A1:B10
أو B:B
التي ترتبط بأعمدة في نهاية النطاق، تعرض هذه
الطريقة true
. بالنسبة إلى النطاقات 3:7
أو A1:5
، التي يتم ربطها فقط بصفوف معيّنة في نهاية النطاق، تعرض هذه الطريقة false
.
تذكرة ذهاب وعودة
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
.
تذكرة ذهاب وعودة
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
.
تذكرة ذهاب وعودة
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
.
تذكرة ذهاب وعودة
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 | القيمة الحمراء بتدوين RGB |
green | Integer | القيمة الخضراء بتدوين RGB |
blue | Integer | القيمة الزرقاء بتدوين RGB |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
تحدّد شبكة مستطيلة بألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق). يتم عرض الألوان في ترميز CSS (مثل '#ffffff'
أو 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setBackgrounds(colors);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String[][] | مصفوفة ألوان ثنائية الأبعاد في تدوين CSS (مثل '#ffffff' أو 'white' )، تعيد قيم null ضبط اللون. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
لضبط موقع الحدود. القيم الصالحة هي true
(تفعيل) وfalse
(إيقاف) وnull
(بدون تغيير).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
top | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
left | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
bottom | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
right | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
vertical | Boolean | true للحدود العمودية الداخلية، false بلا، null بلا تغيير. |
horizontal | Boolean | true للحدود الأفقية الداخلية، وfalse بلا شيء، وnull للتغيير. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
لضبط خاصية الحدود باستخدام اللون و/أو النمط. القيم الصالحة هي true
(تفعيل) وfalse
(إيقاف) وnull
(بدون تغيير). بالنسبة إلى الألوان، استخدِم "اللون" في تدوين CSS (مثل '#ffffff'
أو 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
top | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
left | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
bottom | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
right | Boolean | true للحدود، false بلا شيء، null بلا تغييرات. |
vertical | Boolean | true للحدود العمودية الداخلية، false بلا، null بلا تغيير. |
horizontal | Boolean | true للحدود الأفقية الداخلية، وfalse بلا شيء، وnull للتغيير. |
color | String | لون في تدوين CSS (مثل '#ffffff' أو 'white' )، وnull للون التلقائي (أسود). |
style | BorderStyle | نمط للحدود، وnull للنمط التلقائي (ثابت). |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
لضبط قاعدة واحدة للتحقق من صحة البيانات في كل الخلايا في النطاق.
// Set the data validation rule for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rule | DataValidation | قاعدة التحقق من البيانات المراد إعدادها، أو null لإزالة التحقق من صحة البيانات. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
لضبط قواعد التحقّق من البيانات لجميع الخلايا في النطاق. تأخذ هذه الطريقة مصفوفة ثنائية الأبعاد من عمليات التحقق من صحة البيانات، وتمت فهرستها حسب الصف ثم حسب العمود. يجب أن تتوافق أبعاد الصفيف مع أبعاد النطاق.
// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10. var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); var rules = destinationRange.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
rules | DataValidation[][] | مصفوفة ثنائية الأبعاد من قواعد التحقّق من صحة البيانات المطلوب ضبطها، والقيم null تزيل
التحقّق من صحة البيانات. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
ضبط لون الخط في تدوين CSS (مثل '#ffffff'
أو 'white'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الخط في تدوين CSS (مثل '#ffffff' أو 'white' )، لأنّ قيمة null تعيد ضبط اللون. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
لضبط لون الخط للنطاق المحدّد.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var cell = sheet.getRange("B2"); cell.setFontColor(color);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون الخط الذي يتم ضبطه، تشير القيمة null إلى إعادة ضبط اللون. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
لتحديد شبكة مستطيلة لألوان الخط (يجب أن تتطابق مع أبعاد هذا النطاق).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setFontColorObjects(colors);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
colors | Color[][] | مصفوفة من الألوان ثنائية الأبعاد؛ حيث تعمل قيم null على إعادة ضبط لون الخط. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
لتحديد شبكة مستطيلة لألوان الخط (يجب أن تتطابق مع أبعاد هذا النطاق). يتم عرض الألوان في ترميز CSS (مثل '#ffffff'
أو 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setFontColors(colors);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
colors | Object[][] | مصفوفة ألوان ثنائية الأبعاد في تدوين CSS (مثل '#ffffff' أو 'white' )، تعيد قيم null ضبط اللون. |
تذكرة ذهاب وعودة
Range
— هذا النطاق للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
لتحديد شبكة مستطيلة لمجموعات الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). ومن أمثلتها عائلات الخطوط هي: "&&;;;;&&;;;&;;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)
تعمل هذه السياسة على ضبط مجموعة الخطوط، مثلاً "##;quot;quot;&&;;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)
تحدّد شبكة مستطيلة من ترجيح الخطوط (يجب أن تتطابق مع أبعاد هذا النطاق). ومن الأمثلة على سمك الخط: "bold;bold".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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)
لضبط الرقم أو تنسيق التاريخ على سلسلة التنسيق المحددة. تم وصف أنماط التنسيق المقبولة في مستندات واجهة برمجة تطبيقات جداول البيانات.
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)
تحدّد شبكة مستطيلة للأرقام أو تنسيقات التواريخ (يجب أن تتطابق مع أبعاد هذا النطاق). والقيم هي سلاسل نمط التنسيق كما هو موضح في مستندات واجهة برمجة تطبيقات جداول البيانات.
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)
لتحديد ما إذا كان يجب أن يعرض النطاق روابط تشعّبية أم لا.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
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