Class Range

لضبط النطاق المحدّد على أنه 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 — هذا النطاق للسلاسل.

لضبط الخلية المحددة على أنها 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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

يملأ 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);

المعلّمات

التفويض

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

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

تحسب نطاقًا لملء البيانات الجديدة بناءً على الخلايا المجاورة، ويملأ هذا النطاق تلقائيًا بالقيم الجديدة استنادًا إلى البيانات المتضمّنة في هذا النطاق. ويتم تحديد هذه القيم الجديدة أيضًا من خلال النوع 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);

المعلّمات

التفويض

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

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

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

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

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

// 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

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

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

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

// 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});

المعلّمات

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

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

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

التفويض

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

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

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

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

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

// 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

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

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

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

محو الملاحظة في الخلية أو الخلايا المحددة

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

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

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

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

للحصول على وصف تفصيلي للمعلّمة 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);

المعلّمات

التفويض

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

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

راجع أيضًا

• getGridId()

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

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

المعلّمات

التفويض

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

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

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

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

المعلّمات

التفويض

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

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

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

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

المعلّمات

التفويض

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

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

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

// 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});

المعلّمات

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

التفويض

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

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

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

للحصول على وصف تفصيلي للمعلّمة 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);

المعلّمات

التفويض

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

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

راجع أيضًا

• getGridId()

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

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

المعلّمات

التفويض

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

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

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

يتم إنشاء فلتر وتطبيقه على النطاق المحدّد في ورقة البيانات. لا يمكنك إنشاء أكثر من فلتر واحد في جدول بيانات واحد. للوصول إلى الفلتر وتعديله بعد إنشائه، استخدِم 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);
}

• إنشاء فلتر جدول محوري باستخدام 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

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

المعلّمات

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

PivotTable — PivotTable الجديد.

التفويض

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

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

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

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

المعلّمات

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

TextFinder — TextFinder للنطاق

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

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

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

المعلّمات

التفويض

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

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

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

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

لعرض وصف سلسلة للنطاق، بعلامة 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

لعرض لون خلفية الخلية في أعلى يمين النطاق في النطاق (على سبيل المثال، '#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

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

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

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

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

لعرض ألوان خلفية الخلايا في النطاق (مثل '#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

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

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

لعرض نسخة من النطاق الموسّع في عناصر 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

تعرض نسخة من النطاق الموسّع 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());

المعلّمات

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

Range — نطاق بيانات النطاق أو نطاق يغطي كل عمود أو كل صف يمتد إلى النطاق الأصلي.

التفويض

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

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

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

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

DataSourceFormula — DataSourceFormula للخلية.

التفويض

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

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

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

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

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

<!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

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

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

DataTable: البيانات في شكل جدول بيانات.

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

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

المعلّمات

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

DataTable: البيانات في شكل جدول بيانات.

التفويض

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

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

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

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

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

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

تعرض صفيفًا ثنائي الأبعاد للقيم المعروضة وتمت فهرستها حسب الصف ثم حسب العمود. القيم هي عناصر 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

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

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

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

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

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

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

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

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

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

الحصول على نمط السطر للخلية في أعلى يمين النطاق ('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

للحصول على نمط سطر الخلايا في النطاق ('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

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

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

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

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

لعرض نمط الخط ('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

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

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

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

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

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

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

لعرض الصيغة (تدوين 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

لعرض الصيغة (تدوين 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

لعرض الصيغ (تدوين 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

لعرض الصيغ (تدوين 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

لعرض معرِّف الشبكة للورقة الرئيسية للنطاق. أرقام التعريف هي قيم داخلية غير سالبة عشوائية.

// 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

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

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

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

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

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

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

عرض موضع العمود النهائي

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

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

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

تعرض صفيفًا لكائنات 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 عنصر، تمثّل خلايا مدمَجة تتداخل مع النطاق.

بدءًا من الخلية في العمود الأول وصف الصف، تعرض الخلية التالية في الاتجاه المحدّد وهو حافة نطاق متجاور من الخلايا يتضمن بيانات بداخلها أو الخلية على حافة جدول البيانات في هذا الاتجاه. يعادل ذلك كتابة 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());

المعلّمات

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

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

التفويض

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

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

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

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

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

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

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

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

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

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

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

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

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

لعرض قيمة النص المنسق للخلية العلوية اليمنى من النطاق، أو 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

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

// 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

لعرض موضع الصف لهذا النطاق. متطابق مع 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

لعرض موضع الصف لهذا النطاق. متطابقة مع 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

راجع أيضًا

• getRow()

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

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

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

التفويض

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

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

لعرض اتجاه النص للخلية العلوية اليمنى من النطاق. تعرض 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

لعرض اتجاهات النص للخلايا في النطاق. الإدخالات في المصفوفة الثنائية الأبعاد هي 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

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

// 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

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

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

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

// 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

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

// 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

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

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

Object — القيمة في هذه الخلية.

التفويض

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

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

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

تعرض صفيفًا ثنائي الأبعاد من القيم، وتمت فهرسته حسب الصف، ثم حسب العمود. وقد تكون القيم من النوع 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]);

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

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

التفويض

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

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

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

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

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

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

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

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

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

التفويض

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

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

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

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

// 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

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

// 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

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

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

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

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

المعلّمات

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

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

التفويض

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

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

إدراج مربّعات اختيار في كل خلية في النطاق، وضبطها على 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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

لعرض 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

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

تحدِّد ما إذا كانت نهاية النطاق مرتبطة بعمود معيّن. على سبيل المثال، بالنسبة إلى النطاقات 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

تحدِّد ما إذا كانت نهاية النطاق مرتبطة بصف معيّن. على سبيل المثال، بالنسبة إلى نطاقات 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

لعرض 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.

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

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

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

التفويض

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

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

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

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

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

التفويض

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

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

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

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

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

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

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

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

اقتطِع والصِق (كل من التنسيق والقيم) من هذا النطاق إلى النطاق المستهدَف.

// 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"));

المعلّمات

التفويض

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

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

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

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

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

المعلّمات

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

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

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

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

المعلّمات

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

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

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

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

المعلّمات

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

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

تنشئ عنصرًا يمكنه حماية النطاق من التعديل باستثناء المستخدمين الذين لديهم إذن. إلى أن يغيّر النص البرمجي قائمة محرِّري النطاق فعليًا (من خلال استدعاء 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

التوزيع العشوائي للصفوف في النطاق المحدّد.

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

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

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

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

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

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

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

المعلّمات

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

Range — النطاق الناتج بعد إزالة النُسخ المكرّرة. يتم تقليل حجم النطاق بمقدار صف لكل صف تتم إزالته.

التفويض

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

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

لضبط لون الخلفية لجميع الخلايا في النطاق في تدوين CSS (مثل '#ffffff' أو 'white').

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

المعلّمات

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

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

التفويض

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

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

لضبط لون الخلفية لجميع الخلايا في النطاق.

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

تحدّد شبكة مستطيلة بألوان الخلفية (يجب أن تتطابق مع أبعاد هذا النطاق). يتم عرض الألوان في ترميز 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);

المعلّمات

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

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

التفويض

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

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

لضبط موقع الحدود. القيم الصالحة هي 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);

المعلّمات

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

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

التفويض

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

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

لضبط خاصية الحدود باستخدام اللون و/أو النمط. القيم الصالحة هي 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);

المعلّمات

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

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

التفويض

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

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

لضبط قاعدة واحدة للتحقق من صحة البيانات في كل الخلايا في النطاق.

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

ضبط لون الخط في تدوين CSS (مثل '#ffffff' أو 'white')

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

المعلّمات

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

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

التفويض

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

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

لضبط لون الخط للنطاق المحدّد.

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

لتحديد شبكة مستطيلة لألوان الخط (يجب أن تتطابق مع أبعاد هذا النطاق). يتم عرض الألوان في ترميز 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);

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

تعمل هذه السياسة على ضبط مجموعة الخطوط، مثلاً "##;quot;quot;&&;;Helvetica".

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

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

المعلّمات

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

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

التفويض

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

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

لضبط نمط خط الخط للنطاق المحدّد ('underline' أو 'line-through' أو 'none').

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

لتحديد حجم الخط، بحيث يكون الحجم هو حجم النقطة المطلوب استخدامه.

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

يمكنك ضبط نمط الخط للنطاق المحدّد ('italic' أو 'normal').

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

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

اضبط عرض الخط للنطاق المحدّد (عادي/غامق).

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

يتم تعديل صيغة هذا النطاق. يجب أن تكون الصيغة المحددة بتدوين A1.

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

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

المعلّمات

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

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

التفويض

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

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

يتم تعديل صيغة هذا النطاق. يجب أن تكون الصيغة المحددة بتدوين 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])");

المعلّمات

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

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

التفويض

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

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

تحدِّد شبكة مستطيلة للصيغ (يجب أن تتطابق مع أبعاد هذا النطاق). يجب أن تكون الصِيَغ المحددة تدوين 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);

المعلّمات

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

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

التفويض

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

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

تحدِّد شبكة مستطيلة للصيغ (يجب أن تتطابق مع أبعاد هذا النطاق). يجب أن تكون الصِيَغ المحددة تدوين 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);

المعلّمات

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

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

التفويض

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

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

اضبط المحاذاة الأفقية (من اليسار إلى اليمين) للنطاق المحدّد (يسار/وسط/يمين).

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

المعلّمات

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

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];

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

المعلّمات

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

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.setNote("This is a note");

المعلّمات

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

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

التفويض

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

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

تُحدِّد مجموعة من الملاحظات المستطيلة (يجب أن تتطابق مع أبعاد هذا النطاق).

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)

المعلّمات

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

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");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

لضبط قيمة النص المنسق للخلايا في النطاق.

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

المعلّمات

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

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

التفويض

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

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

تضبط شبكة مستطيلة لقيم النص المنسق.

// 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]]);

المعلّمات

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

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

التفويض

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

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

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

المعلّمات

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

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

التفويض

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

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

لضبط اتجاه النص للخلايا في النطاق. وإذا كان الاتجاه المحدّد هو 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);

المعلّمات

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

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

التفويض

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

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

تضبط شبكة مستطيلة للاتجاهات النصية. وإذا كان الاتجاه المحدّد هو 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());

المعلّمات

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

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

التفويض

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

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

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

بالنسبة إلى اتجاه النص من اليسار إلى اليمين، تكون الزوايا الإيجابية في اتجاه عقارب الساعة، بينما من اليمين إلى اليسار في اتجاه عقارب الساعة.

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

تحدّد شبكة مستطيلة لتدوير النص.

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

المعلّمات

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

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

التفويض

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

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

لضبط نمط النص للخلايا في النطاق.

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

المعلّمات

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

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

التفويض

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

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

تحدِّد شبكة مستطيلة لأنماط النص.

// 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]]);

المعلّمات

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

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

التفويض

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

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

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

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

var cell = sheet.getRange("B2");
cell.setValue(100);

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

راجع أيضًا

• setVerticalAlignment(alignment)

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

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

المعلّمات

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

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

التفويض

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

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

اضبط التفاف الخلية للنطاق المحدّد.

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

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

var cell = sheet.getRange("B2");
cell.setWrap(true);

المعلّمات

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

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

التفويض

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

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

تمثّل هذه السمة شبكة مستطيلة لاستراتيجيات الالتفاف.

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

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

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

المعلّمات

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

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

التفويض

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

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

راجع أيضًا

• setWrap(isWrapEnabled)

لتغيير عمق تجميع الأعمدة للنطاق حسب المبلغ المحدّد.

ويكون لذلك تأثير إنشاء أو تعديل أو حذف مجموعات تتقاطع مع النطاق. بالنسبة إلى الدلتا الإيجابية، يتم إنشاء و/أو تعديل المجموعات، وبالنسبة إلى الدلتا السلبية، يتم تدمير المجموعات و/أو تعديلها.

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

إذا كانت 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);

المعلّمات

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

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

طرح

Error: عند محاولة تغيير عمق العمود الأول عندما يكون موضع التحكّم هو GroupControlTogglePosition.BEFORE

التفويض

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

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

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

ويكون لذلك تأثير إنشاء أو تعديل أو حذف مجموعات تتقاطع مع النطاق. بالنسبة إلى الدلتا الإيجابية، يتم إنشاء و/أو تعديل المجموعات، وبالنسبة إلى الدلتا السلبية، يتم تدمير المجموعات و/أو تعديلها.

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

إذا كانت 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);

المعلّمات

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

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

طرح

Error: عند محاولة تغيير عمق الصف الأول عندما يكون موضع عنصر التحكّم هو GroupControlTogglePosition.BEFORE

التفويض

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

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

لترتيب الخلايا في النطاق المحدد حسب العمود ومن تحديد الترتيب.

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}]);

المعلّمات

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

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

التفويض

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

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

لتقسيم عمود إلى نص إلى أعمدة متعددة استنادًا إلى محدِّد تم الكشف عنه تلقائيًا.

// 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

لتقسيم عمود من النص إلى أعمدة متعددة باستخدام السلسلة المحددة كمُحدِّد مخصّص.

// 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

لتقسيم عمود من النص إلى أعمدة متعددة استنادًا إلى المُحدِّد المحدد.

// 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            |

المعلّمات

التفويض

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

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

لقطع المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في هذا النطاق. لإزالة جميع المسافات البيضاء من بداية كل نص خلية ونهايته والحد من أي تداعيات لأحرف المسافة البيضاء على مسافة واحدة.

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

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

// 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