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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

setRange(range)

لضبط/تحديث النطاق لهذا النطاق المسمى.

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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