Class NamedRange

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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var 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.
var 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