Class NamedRange

به نام محدوده

محدوده های نامگذاری شده را در یک صفحه گسترده ایجاد، دسترسی و اصلاح کنید. محدوده های نامگذاری شده محدوده هایی هستند که دارای نام مستعار رشته ای هستند. آنها را می توان از طریق رابط کاربر برگه ها در منوی Data > Named ranges... مشاهده و ویرایش کرد.

روش ها

روش نوع برگشت شرح مختصر
get Name() String نام این محدوده نامگذاری شده را دریافت می کند.
get Range() Range محدوده ارجاع شده توسط این محدوده نامگذاری شده را دریافت می کند.
remove() void این محدوده نامگذاری شده را حذف می کند.
set Name(name) Named Range نام محدوده نامگذاری شده را تنظیم/به روز می کند.
set Range(range) Named Range محدوده را برای این محدوده نامگذاری شده تنظیم/به روز می کند.

مستندات دقیق

get Name()

نام این محدوده نامگذاری شده را دریافت می کند.

بازگشت

String - نام این محدوده نامگذاری شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Range()

محدوده ارجاع شده توسط این محدوده نامگذاری شده را دریافت می کند.

بازگشت

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

set Name(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 نام جدید محدوده نامگذاری شده.

بازگشت

Named Range - محدوده ای که نام آن توسط تماس تنظیم شده است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Range(range)

محدوده را برای این محدوده نامگذاری شده تنظیم/به روز می کند.

پارامترها

نام تایپ کنید توضیحات
range Range محدوده صفحه گسترده برای مرتبط کردن با این محدوده نامگذاری شده.

بازگشت

Named Range - محدوده نامگذاری شده که محدوده صفحه گسترده برای آن تنظیم شده است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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