इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class NamedRange

एक Range जिसमें एक नाम और आईडी होता है, ताकि उसे बाद में वापस पाया जा सके. नाम ये नहीं हैं यूनीक होना ज़रूरी है; एक ही टैब में कई अलग-अलग रेंज का एक ही नाम हो सकता है. काफ़ी हद तक 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