বিদ্যমান ফিল্টারগুলির মানদণ্ড সম্পর্কে তথ্য পেতে বা অনুলিপি করতে এই ক্লাসটি ব্যবহার করুন।
- একটি নতুন ফিল্টার তৈরি করতে, নিম্নলিখিতগুলি দেখুন:
- শীটের জন্য,
Range.createFilter()ব্যবহার করুন। - পিভট টেবিলের জন্য,
Pivot Table.addFilter(sourceDataColumn, filterCriteria)ব্যবহার করুন। - ডাটাবেসের সাথে সংযুক্ত শিটগুলির জন্য,
Data Source Sheet.addFilter(columnName, filterCriteria)ব্যবহার করুন। - ডাটাবেসের সাথে সংযুক্ত পিভট টেবিলের জন্য,
Data Source Pivot Table.addFilter(columnName, filterCriteria)ব্যবহার করুন।
- শীটের জন্য,
- যেকোনো ধরণের ফিল্টারের জন্য মানদণ্ড তৈরি করতে,
Spreadsheet App.newFilterCriteria()এবংFilter Criteria Builderদেখুন।
সাধারণ ব্যবহার
কপির মানদণ্ড
নিম্নলিখিত নমুনাটিA1:C20 পরিসরে প্রযোজ্য ফিল্টারটি পায়, কলাম C-তে প্রয়োগ করা মানদণ্ডটি পায় এবং কলাম B-তে মানদণ্ডটি অনুলিপি করে। const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Copies the filter criteria applied to column C. const filter = range.getFilter(); const 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 থেকে মানগুলি লগ করে।const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); const filter = range.getFilter(); // Gets the filter criteria applied to column B, then gets the hidden values. const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues(); // Logs the hidden values. console.log(filterCriteria);
পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
copy() | Filter Criteria Builder | এই ফিল্টারের মানদণ্ডটি অনুলিপি করে এবং একটি মানদণ্ড নির্মাতা তৈরি করে যা আপনি অন্য ফিল্টারে প্রয়োগ করতে পারেন। |
get Criteria Type() | Boolean Criteria |null | মানদণ্ডের বুলিয়ান ধরণ প্রদান করে, উদাহরণস্বরূপ, CELL_EMPTY । |
get Criteria Values() | Object[] | বুলিয়ান মানদণ্ডের জন্য আর্গুমেন্টের একটি অ্যারে প্রদান করে। |
get Hidden Values() | String[] | ফিল্টারটি যে মানগুলি লুকায় তা ফেরত পাঠায়। |
get Visible Background Color() | Color |null | ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত পটভূমির রঙ ফেরত পাঠায়। |
get Visible Foreground Color() | Color |null | ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত অগ্রভাগের রঙ ফেরত পাঠায়। |
get Visible Values() | String[] | পিভট টেবিল ফিল্টার যে মানগুলি দেখায় তা ফেরত পাঠায়। |
বিস্তারিত ডকুমেন্টেশন
copy()
এই ফিল্টারের মানদণ্ডটি অনুলিপি করে এবং একটি মানদণ্ড নির্মাতা তৈরি করে যা আপনি অন্য ফিল্টারে প্রয়োগ করতে পারেন।
আপনি যেকোনো ধরণের ফিল্টারের সাথে এই পদ্ধতিটি ব্যবহার করতে পারেন। যদি আপনি একটি শিট ফিল্টার ব্যবহার করেন, তাহলে আপনি মানদণ্ডটি অন্য কলামে অনুলিপি করতে পারেন।
const ss = SpreadsheetApp.getActiveSheet(); const filter = ss.getFilter(); // Makes a copy of the filter criteria applied to column C. const 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);
প্রত্যাবর্তন
Filter Criteria Builder — এই ফিল্টার মানদণ্ডের উপর ভিত্তি করে একটি ফিল্টার মানদণ্ড নির্মাতা।
get Criteria Type()
মানদণ্ডের বুলিয়ান ধরণ, উদাহরণস্বরূপ, CELL_EMPTY প্রদান করে। বুলিয়ান মানদণ্ডের ধরণ সম্পর্কে জানতে, Boolean Criteria enum দেখুন।
লোকেরা প্রায়শই বিদ্যমান মানদণ্ড প্রতিস্থাপন না করে ফিল্টারে বুলিয়ান অবস্থার মানদণ্ড যোগ করার জন্য এই পদ্ধতিটি ব্যবহার করে।
- মানদণ্ডের জন্য আর্গুমেন্ট পেতে,
get Criteria Values()ব্যবহার করুন। - ফিল্টার মানদণ্ড তৈরি বা পরিবর্তন করার জন্য মানদণ্ডের ধরণ এবং মানদণ্ডের মান ব্যবহার করতে,
Filter Criteria Builder.withCriteria(criteria, args)দেখুন।
আপনি যেকোনো ধরণের ফিল্টারের জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন। যদি ফিল্টারের মানদণ্ডটি বুলিয়ান শর্ত না হয়, তাহলে null প্রদান করে।
const ss = SpreadsheetApp.getActiveSheet(); // Gets the filter on the active sheet. const filter = ss.getFilter(); // Gets the criteria type and returns a string representing the criteria type // object. const criteriaType = filter.getColumnFilterCriteria(2).getCriteriaType().toString(); // Logs the criteria type. console.log(criteriaType);
প্রত্যাবর্তন
Boolean Criteria |null — বুলিয়ান মানদণ্ডের ধরণ, অথবা যদি মানদণ্ডটি বুলিয়ান শর্ত না হয় তবে null ।
get Criteria Values()
বুলিয়ান মানদণ্ডের জন্য আর্গুমেন্টের একটি অ্যারে প্রদান করে। কিছু বুলিয়ান মানদণ্ডের ধরণের আর্গুমেন্ট থাকে না এবং একটি খালি অ্যারে প্রদান করে, উদাহরণস্বরূপ, CELL_NOT_EMPTY ।
লোকেরা প্রায়শই বিদ্যমান মানদণ্ড প্রতিস্থাপন না করে ফিল্টারে বুলিয়ান অবস্থার মানদণ্ড যোগ করার জন্য এই পদ্ধতিটি ব্যবহার করে।
- বুলিয়ান মানদণ্ডের ধরণ পেতে,
get Criteria Type()ব্যবহার করুন। - ফিল্টার মানদণ্ড তৈরি বা পরিবর্তন করার জন্য মানদণ্ডের ধরণ এবং মানদণ্ডের মান ব্যবহার করতে,
Filter Criteria Builder.withCriteria(criteria, args)দেখুন।আপনি যেকোনো ধরণের ফিল্টারের জন্য এই পদ্ধতিটি ব্যবহার করতে পারেন।
const ss = SpreadsheetApp.getActiveSheet(); const 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. const criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues(); console.log(criteriaValues);
প্রত্যাবর্তন
Object[]— বুলিয়ান মানদণ্ডের ধরণের সাথে উপযুক্ত আর্গুমেন্টের একটি অ্যারে। আর্গুমেন্টের সংখ্যা এবং তাদের ধরণFilter Criteria Builderক্লাসের সংশ্লিষ্টwhen...()পদ্ধতির সাথে মেলে।
get Hidden Values()
ফিল্টারটি যে মানগুলি লুকায় তা ফেরত পাঠায়।
ডিফল্ট ধরণের শিট Grid শিটে ফিল্টারের ক্ষেত্রে এই মানদণ্ডটি ব্যবহার করুন। অন্যান্য ধরণের ফিল্টারের জন্য এই পদ্ধতিটি কল করলে null ফেরত আসে।
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); const filter = range.getFilter(); // Gets the filter criteria applied to column B, then gets the hidden values. const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues(); // Logs the hidden values. console.log(filterCriteria);
প্রত্যাবর্তন
String[] — ফিল্টারটি লুকায় এমন মানগুলির একটি অ্যারে।
get Visible Background Color()
ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত পটভূমির রঙ ফেরত পাঠায়। এই পটভূমির রঙযুক্ত ঘরগুলি দৃশ্যমান থাকে।
ডিফল্ট ধরণের শিট Grid শিটে ফিল্টারের ক্ষেত্রে এই মানদণ্ডটি ব্যবহার করুন। অন্যান্য ধরণের ফিল্টারের জন্য এই পদ্ধতিটি কল করলে null ফেরত আসে।
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Logs the background color that column B is filtered by as a hexadecimal // string. const filter = range.getFilter(); const color = filter.getColumnFilterCriteria(2) .getVisibleBackgroundColor() .asRgbColor() .asHexString(); console.log(color);
প্রত্যাবর্তন
Color |null — ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত পটভূমির রঙ।
get Visible Foreground Color()
ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত ফোরগ্রাউন্ড রঙটি ফেরত পাঠায়। এই ফোরগ্রাউন্ড রঙের ঘরগুলি দৃশ্যমান থাকে।
ডিফল্ট ধরণের শিট Grid শিটে ফিল্টারের ক্ষেত্রে এই মানদণ্ডটি ব্যবহার করুন। অন্যান্য ধরণের ফিল্টারের জন্য এই পদ্ধতিটি কল করলে null ফেরত আসে।
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Logs the foreground color that column B is filtered by as a hexadecimal // string. const filter = range.getFilter(); const color = filter.getColumnFilterCriteria(2) .getVisibleForegroundColor() .asRgbColor() .asHexString(); console.log(color);
প্রত্যাবর্তন
Color |null — ফিল্টারের মানদণ্ড হিসেবে ব্যবহৃত অগ্রভাগের রঙ।
get Visible Values()
পিভট টেবিল ফিল্টার যে মানগুলি দেখায় তা ফেরত পাঠায়।
এই মানদণ্ডটি শুধুমাত্র পিভট টেবিলের ফিল্টারগুলির জন্য যা কোনও ডাটাবেসের সাথে সংযুক্ত নয়। অন্যান্য ধরণের ফিল্টারের জন্য একটি খালি অ্যারে প্রদান করে।
const ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet, then gets the visible values of its // first filter. const pivotTable = ss.getPivotTables()[0]; const pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues(); // Logs the visible values. console.log(pivotFilterValues);
প্রত্যাবর্তন
String[] — পিভট টেবিল ফিল্টারে প্রদর্শিত মানগুলির একটি অ্যারে।