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

المعلمات

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

الإرجاع

NamedRange - النطاق الذي تم ضبط اسمه بواسطة المكالمة

التفويض

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

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

---

setRange(range)

تعمل هذه السياسة على ضبط/تعديل النطاق لهذا النطاق المُعنوَن.

المعلمات

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

الإرجاع

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

التفويض

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

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