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

المعلَمات

الاسم	النوع	الوصف
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