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