Class NamedRange

Named Range

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