Class RangeList

RangeList

एक ही शीट में एक या उससे ज़्यादा Range इंस्टेंस का कलेक्शन. इस क्लास का इस्तेमाल, रेंज या सेल के कलेक्शन पर कार्रवाई लागू करने के लिए किया जा सकता है.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
activate()RangeListयह Range इंस्टेंस की सूची चुनता है.
breakApart()RangeListश्रेणी सूची में मौजूद सभी क्षैतिज या लंबवत रूप से मर्ज किए गए सेल को अलग-अलग सेल में फिर से विभाजित करें.
check()RangeListरेंज में चेकबॉक्स की स्थिति को “चुनी गई” में बदलता है.
clear()RangeListरेंज की सूची में मौजूद हर Range के लिए, कॉन्टेंट की रेंज, फ़ॉर्मैट, और डेटा की पुष्टि करने के नियमों को मिटा देता है.
clear(options)RangeListदिए गए विकल्पों में बताए गए कॉन्टेंट, फ़ॉर्मैट, डेटा की पुष्टि करने के नियमों, और टिप्पणियों की रेंज को हटाता है.
clearContent()RangeListफ़ॉर्मैटिंग को बनाए रखते हुए, रेंज की सूची में मौजूद हर Range के कॉन्टेंट को हटा देता है.
clearDataValidations()RangeListरेंज की सूची में मौजूद हर Range के लिए, डेटा की पुष्टि करने के नियमों को मिटा देता है.
clearFormat()RangeListश्रेणी सूची में हर Range के लिए टेक्स्ट की फ़ॉर्मैटिंग मिटा देता है.
clearNote()RangeListरेंज की सूची में मौजूद हर Range के लिए, नोट मिटा देता है.
getRanges()Range[]एक ही शीट में एक या उससे ज़्यादा Range इंस्टेंस की सूची दिखाता है.
insertCheckboxes()RangeListरेंज की हर सेल में चेकबॉक्स डालता है. चेकबॉक्स पर सही का निशान लगाने के लिए true के साथ और सही का निशान हटाने के लिए false को कॉन्फ़िगर किया जाता है.
insertCheckboxes(checkedValue)RangeListचुनी गई कस्टम वैल्यू के साथ कॉन्फ़िगर किए गए रेंज की हर सेल में चेकबॉक्स डालता है और सही का निशान हटाने के लिए खाली स्ट्रिंग देता है.
insertCheckboxes(checkedValue, uncheckedValue)RangeListचुनी गई और नहीं चुनी गई स्थितियों के लिए कस्टम मानों के साथ कॉन्फ़िगर किए गए, श्रेणी की हर सेल में चेकबॉक्स डालता है.
removeCheckboxes()RangeListश्रेणी से सभी चेकबॉक्स निकालता है.
setBackground(color)RangeListरेंज की सूची में मौजूद हर Range के लिए, बैकग्राउंड का रंग सेट करता है.
setBackgroundRGB(red, green, blue)RangeListबैकग्राउंड को दिए गए आरजीबी रंग में सेट करता है.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListरेंज की सूची में मौजूद हर Range के लिए, बॉर्डर प्रॉपर्टी सेट करता है.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListरेंज की सूची में मौजूद हर Range के लिए, बॉर्डर प्रॉपर्टी को रंग और/या स्टाइल के साथ सेट करता है.
setFontColor(color)RangeListरेंज की सूची में हर Range के लिए फ़ॉन्ट का रंग सेट करता है.
setFontFamily(fontFamily)RangeListरेंज की सूची में मौजूद हर Range के लिए, फ़ॉन्ट फ़ैमिली सेट करता है.
setFontLine(fontLine)RangeListरेंज की सूची में हर Range के लिए, फ़ॉन्ट लाइन का स्टाइल सेट करता है.
setFontSize(size)RangeListरेंज की सूची में हर Range के लिए, फ़ॉन्ट का साइज़ (पॉइंट में) सेट करता है.
setFontStyle(fontStyle)RangeListरेंज की सूची में, हर Range के लिए फ़ॉन्ट स्टाइल सेट करें.
setFontWeight(fontWeight)RangeListरेंज की सूची में हर Range के लिए, फ़ॉन्ट की मोटाई सेट करें.
setFormula(formula)RangeListरेंज की सूची में हर Range के लिए, फ़ॉर्मूला अपडेट करता है.
setFormulaR1C1(formula)RangeListरेंज की सूची में हर Range के लिए, फ़ॉर्मूला अपडेट करता है.
setHorizontalAlignment(alignment)RangeListरेंज की सूची में हर Range के लिए, हॉरिज़ॉन्टल अलाइनमेंट सेट करें.
setNote(note)RangeListरेंज की सूची में हर Range के लिए, नोट टेक्स्ट सेट करता है.
setNumberFormat(numberFormat)RangeListरेंज की सूची में मौजूद हर Range के लिए, संख्या या तारीख का फ़ॉर्मैट सेट करता है.
setShowHyperlink(showHyperlink)RangeListसेट करता है कि रेंज की सूची में मौजूद हर Range को हाइपरलिंक दिखाना चाहिए या नहीं.
setTextDirection(direction)RangeListरेंज की सूची में, हर Range के सेल के लिए टेक्स्ट की दिशा सेट करता है.
setTextRotation(degrees)RangeListरेंज की सूची में हर Range में मौजूद सेल के लिए, टेक्स्ट घुमाने की सेटिंग सेट करता है.
setValue(value)RangeListरेंज की सूची में हर Range के लिए वैल्यू सेट करता है.
setVerticalAlignment(alignment)RangeListरेंज की सूची में हर Range के लिए, वर्टिकल अलाइनमेंट सेट करें.
setVerticalText(isVertical)RangeListसेट करता है कि रेंज सूची में हर Range के लिए, सेल के लिए टेक्स्ट को स्टैक करना है या नहीं.
setWrap(isWrapEnabled)RangeListरेंज की सूची में, हर Range के लिए टेक्स्ट रैपिंग सेट करें.
setWrapStrategy(strategy)RangeListरेंज की सूची में, हर Range के लिए टेक्स्ट रैपिंग की रणनीति सेट करती है.
trimWhitespace()RangeListइस रेंज की सूची में हर सेल में खाली सफ़ेद जगह (जैसे कि खाली जगह, टैब या नई लाइन) में काट-छांट करता है.
uncheck()RangeListरेंज में चेकबॉक्स की स्थिति को “सही का निशान हटाया गया” में बदलता है.

ज़्यादा जानकारी के साथ दस्तावेज़

activate()

यह Range इंस्टेंस की सूची चुनता है. सूची में आखिरी रेंज को active range के तौर पर सेट किया गया है.

ध्यान दें: इससे कई रेंज को एक से ज़्यादा बार चुना जा सकता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

रिटर्न

RangeList — चेन बनाने के लिए, ऐक्टिव रेंज की सूची.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

breakApart()

श्रेणी सूची में मौजूद सभी क्षैतिज या लंबवत रूप से मर्ज किए गए सेल को अलग-अलग सेल में फिर से विभाजित करें.

इस फ़ंक्शन को किसी श्रेणी की सूची में कॉल करना, रेंज के सेट को चुनने और शीट के मेन्यू आइटम फ़ॉर्मैट > मर्ज करें > अनमर्ज करें करने के बराबर है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

check()

रेंज में चेकबॉक्स की स्थिति को "चुनी गई" में बदलता है. उस रेंज में मौजूद सेल को अनदेखा करता है जिसमें फ़िलहाल, कॉन्फ़िगर किया गया या सही का निशान हटाया गया मान नहीं है.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'checked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clear()

रेंज की सूची में मौजूद हर Range के लिए, कॉन्टेंट की रेंज, फ़ॉर्मैट, और डेटा की पुष्टि करने के नियमों को मिटा देता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clear(options)

दिए गए विकल्पों में बताए गए कॉन्टेंट, फ़ॉर्मैट, डेटा की पुष्टि करने के नियमों, और टिप्पणियों की रेंज को हटाता है. डिफ़ॉल्ट रूप से, सारा डेटा मिटा दिया जाता है.

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

पैरामीटर

नामTypeब्यौरा
optionsObjectबेहतर पैरामीटर के बारे में बताने वाला JavaScript ऑब्जेक्ट, जैसा कि नीचे दिया गया है.

उन्नत पैरामीटर

नामTypeब्यौरा
commentsOnlyBooleanसिर्फ़ टिप्पणियों को मिटाना है या नहीं.
contentsOnlyBooleanक्या सिर्फ़ कॉन्टेंट मिटाना है.
formatOnlyBooleanक्या सिर्फ़ फ़ॉर्मैट को मिटाना है; ध्यान दें कि डेटा मिटाने के फ़ॉर्मैट से, डेटा की पुष्टि करने के नियम भी मिट जाते हैं.
validationsOnlyBooleanसिर्फ़ डेटा की पुष्टि करने के नियमों को मिटाना है या नहीं.
skipFilteredRowsBooleanफ़िल्टर की गई पंक्तियों को मिटाने से बचना है या नहीं.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clearContent()

फ़ॉर्मैटिंग को बनाए रखते हुए, रेंज की सूची में मौजूद हर Range के कॉन्टेंट को हटा देता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clearDataValidations()

रेंज की सूची में मौजूद हर Range के लिए, डेटा की पुष्टि करने के नियमों को मिटा देता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clearFormat()

श्रेणी सूची में हर Range के लिए टेक्स्ट की फ़ॉर्मैटिंग मिटा देता है.

इससे हर रेंज के लिए टेक्स्ट की फ़ॉर्मैटिंग हट जाती है, लेकिन संख्या फ़ॉर्मैटिंग के किसी नियम को रीसेट नहीं किया जाता.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

clearNote()

रेंज की सूची में मौजूद हर Range के लिए, नोट मिटा देता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

getRanges()

एक ही शीट में एक या उससे ज़्यादा Range इंस्टेंस की सूची दिखाता है.

रिटर्न

Range[] — रेंज की सूची.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

insertCheckboxes()

रेंज की हर सेल में चेकबॉक्स डालता है. चेकबॉक्स पर सही का निशान लगाने के लिए true के साथ और सही का निशान हटाने के लिए false को कॉन्फ़िगर किया जाता है. रेंज में सभी सेल की वैल्यू को false पर सेट करता है.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

insertCheckboxes(checkedValue)

चुनी गई कस्टम वैल्यू के साथ कॉन्फ़िगर किए गए रेंज की हर सेल में चेकबॉक्स डालता है और सही का निशान हटाने के लिए खाली स्ट्रिंग देता है. रेंज में हर सेल की वैल्यू को खाली स्ट्रिंग पर सेट करता है.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

पैरामीटर

नामTypeब्यौरा
checkedValueObjectचेकबॉक्स डेटा की पुष्टि के लिए चुना गया मान.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

insertCheckboxes(checkedValue, uncheckedValue)

चुनी गई और नहीं चुनी गई स्थितियों के लिए कस्टम मानों के साथ कॉन्फ़िगर किए गए, श्रेणी की हर सेल में चेकबॉक्स डालता है. यह फ़ंक्शन, रेंज में हर सेल की वैल्यू को पसंद के मुताबिक नहीं चुनी गई वैल्यू पर सेट करता है.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

पैरामीटर

नामTypeब्यौरा
checkedValueObjectचेकबॉक्स डेटा की पुष्टि के लिए चुना गया मान.
uncheckedValueObjectचेकबॉक्स डेटा की पुष्टि के लिए सही का निशान हटाया गया मान.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

removeCheckboxes()

श्रेणी से सभी चेकबॉक्स निकालता है. हर सेल के डेटा की पुष्टि करता है. साथ ही, अगर सेल में सही का निशान लगाया गया है या नहीं, तो इसका मान भी हटाता है.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setBackground(color)

रेंज की सूची में मौजूद हर Range के लिए, बैकग्राउंड का रंग सेट करता है. रंग को सीएसएस नोटेशन में दिखाया जाता है; उदाहरण के लिए, '#ffffff' या 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

पैरामीटर

नामTypeब्यौरा
colorStringसीएसएस नोटेशन में बैकग्राउंड का रंग कोड, जैसे कि '#ffffff' या 'white'; null वैल्यू से रंग रीसेट हो जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setBackgroundRGB(red, green, blue)

बैकग्राउंड को दिए गए आरजीबी रंग में सेट करता है. यह setBackground(color) कॉल के आस-पास सुविधा रैपर है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

पैरामीटर

नामTypeब्यौरा
redIntegerआरजीबी नोटेशन में लाल रंग की वैल्यू.
greenIntegerआरजीबी नोटेशन में हरे रंग की वैल्यू.
blueIntegerआरजीबी नोटेशन में नीले रंग की वैल्यू.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setBorder(top, left, bottom, right, vertical, horizontal)

रेंज की सूची में मौजूद हर Range के लिए, बॉर्डर प्रॉपर्टी सेट करता है. मान्य वैल्यू ये हैं: true (चालू है), false (बंद है), और null (कोई बदलाव नहीं).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

पैरामीटर

नामTypeब्यौरा
topBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
leftBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
bottomBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
rightBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
verticalBooleanआंतरिक वर्टिकल बॉर्डर के लिए true, किसी के लिए false नहीं, बिना किसी बदलाव के null.
horizontalBooleanआंतरिक हॉरिज़ॉन्टल बॉर्डर के लिए true, किसी के लिए false नहीं, किसी बदलाव के लिए null.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

रेंज की सूची में मौजूद हर Range के लिए, बॉर्डर प्रॉपर्टी को रंग और/या स्टाइल के साथ सेट करता है. मान्य वैल्यू ये हैं: true (चालू है), false (बंद है), और null (कोई बदलाव नहीं). रंग को सीएसएस नोटेशन में दिखाया जाता है; उदाहरण के लिए, '#ffffff' या 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

पैरामीटर

नामTypeब्यौरा
topBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
leftBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
bottomBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
rightBooleanबॉर्डर के लिए true, किसी के लिए false, बिना किसी बदलाव के null.
verticalBooleanआंतरिक वर्टिकल बॉर्डर के लिए true, किसी के लिए false नहीं, बिना किसी बदलाव के null.
horizontalBooleanआंतरिक हॉरिज़ॉन्टल बॉर्डर के लिए true, किसी के लिए false नहीं, किसी बदलाव के लिए null.
colorStringसीएसएस नोटेशन में बॉर्डर का रंग, जैसे कि '#ffffff' या 'white', डिफ़ॉल्ट रंग के लिए null (काला).
styleBorderStyleबॉर्डर की स्टाइल, डिफ़ॉल्ट स्टाइल (सॉलिड) के लिए null.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontColor(color)

रेंज की सूची में हर Range के लिए फ़ॉन्ट का रंग सेट करता है. रंग को सीएसएस नोटेशन में दिखाया जाता है; उदाहरण के लिए, '#ffffff' या 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

पैरामीटर

नामTypeब्यौरा
colorStringसीएसएस नोटेशन में फ़ॉन्ट का रंग, जैसे कि '#ffffff' या 'white'; null वैल्यू से रंग रीसेट हो जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontFamily(fontFamily)

रेंज की सूची में मौजूद हर Range के लिए, फ़ॉन्ट फ़ैमिली सेट करता है. फ़ॉन्ट फ़ैमिली की जानकारी, Arial या Roboto जैसे स्ट्रिंग आइडेंटिफ़ायर से दी जाती है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

पैरामीटर

नामTypeब्यौरा
fontFamilyStringसेट की जाने वाली फ़ॉन्ट फ़ैमिली; null वैल्यू, फ़ॉन्ट फ़ैमिली को रीसेट करती है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontLine(fontLine)

रेंज की सूची में हर Range के लिए, फ़ॉन्ट लाइन का स्टाइल सेट करता है. लाइन स्टाइल के विकल्प 'underline', 'line-through' या 'none' हैं.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

पैरामीटर

नामTypeब्यौरा
fontLineStringफ़ॉन्ट लाइन की स्टाइल, 'underline', 'line-through' या 'none'; null वैल्यू से फ़ॉन्ट लाइन का स्टाइल रीसेट होता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontSize(size)

रेंज की सूची में हर Range के लिए, फ़ॉन्ट का साइज़ (पॉइंट में) सेट करता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

पैरामीटर

नामTypeब्यौरा
sizeIntegerफ़ॉन्ट पॉइंट का साइज़.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontStyle(fontStyle)

रेंज की सूची में, हर Range के लिए फ़ॉन्ट स्टाइल सेट करें. फ़ॉन्ट स्टाइल के विकल्प 'italic' या 'normal' हैं.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle("italic");

पैरामीटर

नामTypeब्यौरा
fontStyleStringफ़ॉन्ट स्टाइल, 'italic' या 'normal'; null वैल्यू, फ़ॉन्ट स्टाइल को रीसेट करती है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFontWeight(fontWeight)

रेंज की सूची में हर Range के लिए, फ़ॉन्ट की मोटाई सेट करें. फ़ॉन्ट की मोटाई के विकल्प 'normal' या 'bold' हैं.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

पैरामीटर

नामTypeब्यौरा
fontWeightStringफ़ॉन्ट की मोटाई 'bold' या 'normal' हो; null वैल्यू से फ़ॉन्ट की मोटाई रीसेट हो जाती है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFormula(formula)

रेंज की सूची में हर Range के लिए, फ़ॉर्मूला अपडेट करता है. दिया गया फ़ॉर्मूला A1 नोटेशन में होना चाहिए.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

पैरामीटर

नामTypeब्यौरा
formulaStringसेट किए जाने वाले फ़ॉर्मूला को दिखाने वाली स्ट्रिंग.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setFormulaR1C1(formula)

रेंज की सूची में हर Range के लिए, फ़ॉर्मूला अपडेट करता है. दिया गया फ़ॉर्मूला R1C1 नोटेशन में होना चाहिए.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

पैरामीटर

नामTypeब्यौरा
formulaStringस्ट्रिंग फ़ॉर्मूला.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setHorizontalAlignment(alignment)

रेंज की सूची में हर Range के लिए, हॉरिज़ॉन्टल अलाइनमेंट सेट करें. अलाइनमेंट के विकल्प 'left', 'center' या 'right' हैं.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment("center");

पैरामीटर

नामTypeब्यौरा
alignmentStringअलाइनमेंट, 'left', 'center' या 'normal'; किसी null वैल्यू से अलाइनमेंट रीसेट हो जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setNote(note)

रेंज की सूची में हर Range के लिए, नोट टेक्स्ट सेट करता है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

पैरामीटर

नामTypeब्यौरा
noteStringसेट किया जाने वाला नोट टेक्स्ट; null वैल्यू से नोट हट जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setNumberFormat(numberFormat)

रेंज की सूची में मौजूद हर Range के लिए, संख्या या तारीख का फ़ॉर्मैट सेट करता है.

स्वीकार किए गए फ़ॉर्मैटिंग पैटर्न के बारे में Sheets API की तारीख और संख्या का फ़ॉर्मैट बताने वाली गाइड में बताया गया है.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

पैरामीटर

नामTypeब्यौरा
numberFormatStringसंख्या के फ़ॉर्मैट वाली स्ट्रिंग.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

सेट करता है कि रेंज की सूची में मौजूद हर Range को हाइपरलिंक दिखाना चाहिए या नहीं.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

पैरामीटर

नामTypeब्यौरा
showHyperlinkBooleanहाइपरलिंक दिखाना है या नहीं.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setTextDirection(direction)

रेंज की सूची में, हर Range के सेल के लिए टेक्स्ट की दिशा सेट करता है. अगर बताई गई दिशा null है, तो दिशा का अनुमान लगाया जाता है और फिर सेट किया जाता है.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

पैरामीटर

नामTypeब्यौरा
directionTextDirectionमनचाहे टेक्स्ट की दिशा; अगर null है, तो सेटिंग से पहले निर्देश का अनुमान लगाया जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setTextRotation(degrees)

रेंज की सूची में हर Range में मौजूद सेल के लिए, टेक्स्ट घुमाने की सेटिंग सेट करता है. इनपुट, स्टैंडर्ड टेक्स्ट ओरिएंटेशन और मनचाहे ओरिएंटेशन के बीच के ऐंगल से जुड़ा होता है. शून्य का इनपुट बताता है कि टेक्स्ट, स्टैंडर्ड ओरिएंटेशन पर सेट है.

टेक्स्ट की दिशा बाईं से दाईं ओर के लिए, पॉज़िटिव कोण घड़ी की उलटी दिशा में होते हैं, वहीं दाईं से बाईं ओर वे घड़ी की दिशा में होते हैं.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

पैरामीटर

नामTypeब्यौरा
degreesIntegerस्टैंडर्ड ओरिएंटेशन और पसंदीदा ओरिएंटेशन के बीच का पसंदीदा ऐंगल. बाएं से दाएं टेक्स्ट के लिए, पॉज़िटिव कोण घड़ी की उलटी दिशा में होते हैं.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setValue(value)

रेंज की सूची में हर Range के लिए वैल्यू सेट करता है. वैल्यू संख्या, स्ट्रिंग, बूलियन या तारीख हो सकती है. अगर यह '=' से शुरू होता है, तो इसे एक फ़ॉर्मूला माना जाता है.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

पैरामीटर

नामTypeब्यौरा
valueObjectरेंज के लिए वैल्यू.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setVerticalAlignment(alignment)

रेंज की सूची में हर Range के लिए, वर्टिकल अलाइनमेंट सेट करें. अलाइनमेंट के विकल्प 'top', 'middle' या 'bottom' हैं.

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

पैरामीटर

नामTypeब्यौरा
alignmentStringअलाइनमेंट, 'top', 'middle' या 'bottom'; किसी null वैल्यू से अलाइनमेंट रीसेट हो जाता है.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setVerticalText(isVertical)

सेट करता है कि रेंज सूची में हर Range के लिए, सेल के लिए टेक्स्ट को स्टैक करना है या नहीं. अगर टेक्स्ट वर्टिकल तरीके से स्टैक किया गया है, तो डिग्री टेक्स्ट रोटेशन की सेटिंग को अनदेखा कर दिया जाता है.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

पैरामीटर

नामTypeब्यौरा
isVerticalBooleanटेक्स्ट को स्टैक करना है या नहीं.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setWrap(isWrapEnabled)

रेंज की सूची में, हर Range के लिए टेक्स्ट रैपिंग सेट करें. जिन सेल में रैप चालू है उनका पूरा कॉन्टेंट दिखाने के लिए साइज़ बदल जाता है. जिन सेल को रैप करने की सुविधा बंद है उन्हें साइज़ बदलने या एक से ज़्यादा लाइनों पर चलाए बिना, सेल में जितना हो सके उतना दिखाया जाता है.

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

पैरामीटर

नामTypeब्यौरा
isWrapEnabledBooleanटेक्स्ट रैप करना है या नहीं.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

setWrapStrategy(strategy)

रेंज की सूची में, हर Range के लिए टेक्स्ट रैपिंग की रणनीति सेट करती है.

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

पैरामीटर

नामTypeब्यौरा
strategyWrapStrategyरैपिंग के लिए आपकी पसंद की रणनीति.

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

trimWhitespace()

इस रेंज की सूची में हर सेल में खाली सफ़ेद जगह (जैसे कि खाली जगह, टैब या नई लाइन) में काट-छांट करता है. हर सेल के टेक्स्ट की शुरुआत और आखिर से सभी खाली सफ़ेद जगह हटा देता है और बाकी खाली सफ़ेद जगह के किसी भी क्रम को एक स्पेस में कम कर देता है.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

इन्हें भी देखें


uncheck()

रेंज में चेकबॉक्स की स्थिति को “सही का निशान हटाया गया” में बदलता है. रेंज में उन सेल को अनदेखा करता है जिनमें फ़िलहाल, कॉन्फ़िगर किया गया या नहीं चुना गया मान शामिल नहीं है.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

रिटर्न

RangeList — यह रेंज की सूची, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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