این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class NamedRange

Range ای که دارای نام و شناسه است تا امکان بازیابی بعدی را فراهم کند. نام ها لزوما منحصر به فرد نیستند. چندین محدوده مختلف در یک برگه ممکن است نام یکسانی داشته باشند، بسیار شبیه یک کلاس در HTML. در مقابل، شناسه‌ها مانند شناسه در HTML منحصربه‌فرد هستند. هنگامی که یک NamedRange به یک برگه اضافه شد، نمی توان آن را تغییر داد، فقط حذف کرد.

یک NamedRange با هر اسکریپتی که به برگه دسترسی دارد قابل دسترسی است. برای جلوگیری از درگیری های ناخواسته بین اسکریپت ها، پیشوند نام محدوده را با یک رشته منحصر به فرد در نظر بگیرید.

// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

روش ها

روش	نوع برگشت	شرح مختصر
`getId()`	`String`	شناسه این `NamedRange` را دریافت می کند.
`getName()`	`String`	نام این `NamedRange` را می گیرد.
`getRange()`	`Range`	محدوده عناصر مرتبط با این `NamedRange` را دریافت می کند.
`remove()`	`void`	این `NamedRange` از برگه حذف می کند.

مستندات دقیق

`getId()`

شناسه این NamedRange را دریافت می کند. شناسه در برگه منحصر به فرد است.

بازگشت

String - شناسه محدوده، که در برگه منحصر به فرد است.

`getName()`

نام این NamedRange را می گیرد. نام لزوما منحصر به فرد نیست.

بازگشت

String - نام محدوده، که لزوما منحصر به فرد نیست.

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getRange()`

محدوده عناصر مرتبط با این NamedRange را دریافت می کند.

بازگشت

Range - محدوده عناصر مرتبط با نام و شناسه.

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`remove()`

این NamedRange از برگه حذف می کند. این روش محتویات محدوده را حذف نمی کند. این فقط مرجع را حذف می کند. فراخوانی این روش بر روی NamedRange که قبلاً حذف شده است تأثیری ندارد.

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

روش ها

روش	نوع برگشت	شرح مختصر
`getId()`	`String`	شناسه این `NamedRange` را دریافت می کند.
`getName()`	`String`	نام این `NamedRange` را می گیرد.
`getRange()`	`Range`	محدوده عناصر مرتبط با این `NamedRange` را دریافت می کند.
`remove()`	`void`	این `NamedRange` از برگه حذف می کند.

مستندات دقیق

`getId()`

شناسه این NamedRange را دریافت می کند. شناسه در برگه منحصر به فرد است.

بازگشت

String - شناسه محدوده، که در برگه منحصر به فرد است.

`getName()`

نام این NamedRange را می گیرد. نام لزوما منحصر به فرد نیست.

بازگشت

String - نام محدوده، که لزوما منحصر به فرد نیست.

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getRange()`

محدوده عناصر مرتبط با این NamedRange را دریافت می کند.

بازگشت

Range - محدوده عناصر مرتبط با نام و شناسه.

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`remove()`

مجوز

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents