محدوده های نامگذاری شده را در یک صفحه گسترده ایجاد، دسترسی و اصلاح کنید. محدوده های نامگذاری شده محدوده هایی هستند که دارای نام مستعار رشته ای هستند. آنها را می توان از طریق رابط کاربر برگه ها در منوی Data > Named ranges... مشاهده و ویرایش کرد.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
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