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