Class FilterCriteria

FilterCriteria

मौजूदा फ़िल्टर के बारे में जानकारी पाने या उन शर्तों को कॉपी करने के लिए, इस क्लास का इस्तेमाल करें.

सामान्य तौर पर क्वेरी की सूची का इस्तेमाल इस तरह किया जाता है

शर्तें कॉपी करें

नीचे दिए गए सैंपल में, A1:C20 रेंज पर लागू होने वाला फ़िल्टर लगाया गया है. साथ ही, इसे शर्तों के हिसाब से बनाया गया है कॉलम C पर लागू किया जाता है और शर्तों को कॉलम B में कॉपी किया जाता है. 
let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Copies the filter criteria applied to column C.
let filter = range.getFilter();
let criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any existing
// criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

फ़िल्टर की मदद से छिपाई गई वैल्यू पाएं

नीचे दिया गया सैंपल, दी गई रेंज पर लागू होने वाला फ़िल्टर हासिल करता है और इससे वैल्यू लॉग करता है कॉलम B को दिखाता है, जिसे फ़िल्टर छिपाता है. 
let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
copy()FilterCriteriaBuilderइस फ़िल्टर के मानदंड की कॉपी बनाकर, ऐसा मानदंड बिल्डर बनाता है जिसे आप दूसरे मानदंड पर लागू कर सकते हैं फ़िल्टर.
getCriteriaType()BooleanCriteriaयह फ़ंक्शन मानदंड के बूलियन टाइप को दिखाता है, जैसे कि CELL_EMPTY.
getCriteriaValues()Object[]बूलियन मापदंड के लिए तर्कों की श्रेणी देता है.
getHiddenValues()String[]उन वैल्यू को दिखाता है जिन्हें फ़िल्टर छिपाता है.
getVisibleBackgroundColor()Colorफ़िल्टर करने की शर्तों के तौर पर इस्तेमाल किए गए बैकग्राउंड का रंग दिखाता है.
getVisibleForegroundColor()Colorफ़िल्टर की शर्तों के तौर पर इस्तेमाल किया गया फ़ोरग्राउंड का रंग दिखाता है.
getVisibleValues()String[]उन वैल्यू को दिखाता है जो पिवट टेबल के फ़िल्टर में दिखती हैं.

विस्तृत दस्तावेज़

copy()

इस फ़िल्टर के मानदंड की कॉपी बनाकर, ऐसा मानदंड बिल्डर बनाता है जिसे आप दूसरे मानदंड पर लागू कर सकते हैं फ़िल्टर.

इस तरीके का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. शीट फ़िल्टर का इस्तेमाल करते समय, ये काम किए जा सकते हैं मानदंड को किसी अन्य कॉलम में कॉपी करें. 

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
let criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any existing
// criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

वापसी का टिकट

FilterCriteriaBuilder — इस फ़िल्टर मानदंड पर आधारित एक फ़िल्टर मानदंड निर्माता.

getCriteriaType()

यह फ़ंक्शन मानदंड के बूलियन टाइप को दिखाता है, जैसे कि CELL_EMPTY. अलग-अलग तरह के विषयों के बारे में जानने के लिए की वैल्यू के तौर पर BooleanCriteria की वैल्यू देखें.

लोग अक्सर यह तरीका इस्तेमाल करके, फ़िल्टर को बदले बिना ही उस फ़िल्टर में बूलियन शर्त की शर्त जोड़ सकते हैं मौजूदा मानदंड.

  • मानदंड के लिए तर्क पाने के लिए, getCriteriaValues() का इस्तेमाल करें.
  • फ़िल्टर की शर्तें बनाने या उनमें बदलाव करने के लिए, मानदंड के टाइप और शर्तों की वैल्यू का इस्तेमाल करने के लिए, यह देखें FilterCriteriaBuilder.withCriteria(criteria, args).

किसी भी तरह के फ़िल्टर के लिए, इस तरीके का इस्तेमाल किया जा सकता है. अगर फ़िल्टर की शर्त बूलियन नहीं है स्थिति, null दिखाता है. 

let ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
let filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type object.
let criteriaType = filter.getColumnFilterCriteria(2)
                         .getCriteriaType()
                         .toString();
// Logs the criteria type.
console.log(criteriaType);

वापसी का टिकट

BooleanCriteria — बूलियन मानदंड का प्रकार या अगर मानदंड बूलियन नहीं है, तो null स्थिति.

getCriteriaValues()

बूलियन मापदंड के लिए तर्कों की श्रेणी देता है. कुछ बूलियन मानदंड प्रकारों में आर्ग्युमेंट और खाली अरे दिखाएं, जैसे कि CELL_NOT_EMPTY.

लोग अक्सर यह तरीका इस्तेमाल करके, फ़िल्टर को बदले बिना ही उस फ़िल्टर में बूलियन शर्त की शर्त जोड़ सकते हैं मौजूदा मानदंड.

  • बूलियन मापदंड प्रकार पाने के लिए, getCriteriaType() का इस्तेमाल करें.
  • फ़िल्टर करने की शर्त बनाने या उसमें बदलाव करने के लिए, मानदंड के टाइप और शर्तों की वैल्यू का इस्तेमाल करने के लिए, यह देखें FilterCriteriaBuilder.withCriteria(criteria, args).

    किसी भी तरह के फ़िल्टर के लिए, इस तरीके का इस्तेमाल किया जा सकता है. 

    let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the values of the boolean criteria and logs them. For example, if the boolean
// condition is whenNumberGreaterThan(10), then the logged value is 10.
let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
console.log(criteriaValues);

    वापसी का टिकट

    Object[] — बूलियन शर्तों के टाइप के हिसाब से सही आर्ग्युमेंट का कलेक्शन. आर्ग्युमेंट की संख्या और उनका टाइप, FilterCriteriaBuilder क्लास के when...() तरीके से मेल खाता है.

getHiddenValues()

उन वैल्यू को दिखाता है जिन्हें फ़िल्टर छिपाता है.

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप है. अगर अन्य तरह के फ़िल्टर के लिए, इस तरीके को कॉल किया जाता है, तो null फ़ंक्शन दिखाता है. 

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

वापसी का टिकट

String[] — उन वैल्यू का कलेक्शन जिन्हें फ़िल्टर छिपाता है.

getVisibleBackgroundColor()

फ़िल्टर करने की शर्तों के तौर पर इस्तेमाल किए गए बैकग्राउंड का रंग दिखाता है. इस बैकग्राउंड रंग वाली सेल मौजूद रहेंगी दृश्य.

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप है. अगर अन्य तरह के फ़िल्टर के लिए, इस तरीके को कॉल किया जाता है, तो null फ़ंक्शन दिखाता है. 

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the background color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

वापसी का टिकट

Color — फ़िल्टर की शर्तों के तौर पर, बैकग्राउंड का रंग इस्तेमाल किया जाता है.

getVisibleForegroundColor()

फ़िल्टर की शर्तों के तौर पर इस्तेमाल किया गया फ़ोरग्राउंड का रंग दिखाता है. इस रंग के फ़ोरग्राउंड वाली सेल मौजूद रहेंगी दृश्य.

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप है. अगर अन्य तरह के फ़िल्टर के लिए, इस तरीके को कॉल किया जाता है, तो null फ़ंक्शन दिखाता है. 

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the foreground color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

वापसी का टिकट

Color — फ़िल्टर की शर्तों के तौर पर, फ़ोरग्राउंड का रंग इस्तेमाल किया जाता है.

getVisibleValues()

उन वैल्यू को दिखाता है जो पिवट टेबल के फ़िल्टर में दिखती हैं.

यह शर्त सिर्फ़ उन पिवट टेबल के फ़िल्टर के लिए है जो किसी डेटाबेस से कनेक्ट नहीं हैं. अन्य तरह के फ़िल्टर के लिए, खाली अरे दिखाता है. 

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

वापसी का टिकट

String[] — उन वैल्यू का कलेक्शन जो पिवट टेबल के फ़िल्टर में दिखती हैं.