Class NamedRange

النطاق المُعنوَن

إنشاء النطاقات المُعنوَنة والوصول إليها وتعديلها في جدول بيانات النطاقات المُعنوَنة هي نطاقات لها أسماء بديلة مرتبطة بسلاسل. ويمكن عرضها وتعديلها من خلال واجهة مستخدم "جداول بيانات Google" ضمن القائمة البيانات > النطاقات المُسمّاة....

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getName()Stringتحصل على اسم هذا النطاق المُعنوَن.
getRange()Rangeتحصل على النطاق المُشار إليه بهذا النطاق المُعنوَن.
remove()voidيؤدي إلى حذف هذا النطاق المُعنوَن.
setName(name)NamedRangeتُستخدَم لضبط/تعديل اسم النطاق المُعنون.
setRange(range)NamedRangeتُستخدَم لضبط النطاق لهذا النطاق المُعنوَن أو تعديله.

مستندات تفصيلية

getName()

تحصل على اسم هذا النطاق المُعنوَن.

الإرجاع

String: اسم النطاق المُعنوَن

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getRange()

تحصل على النطاق المُشار إليه بهذا النطاق المُعنوَن.

الإرجاع

Range: نطاق جدول البيانات المرتبط بهذا النطاق المُعنوَن

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

remove()

يؤدي إلى حذف هذا النطاق المُعنوَن. 

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setName(name)

تُستخدَم لضبط/تعديل اسم النطاق المُعنون. 

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

المعلمات

الاسمالنوعالوصف
nameStringالاسم الجديد للنطاق المُعنوَن.

الإرجاع

NamedRange: النطاق الذي تم ضبط اسمه من خلال الطلب

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setRange(range)

تُستخدَم لضبط النطاق لهذا النطاق المُعنوَن أو تعديله.

المعلمات

الاسمالنوعالوصف
rangeRangeنطاق جدول البيانات المطلوب ربطه بهذا النطاق المُعنوَن

الإرجاع

NamedRange: النطاق المُعنوَن الذي تم ضبط نطاق جدول البيانات له

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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