Class Filter

ফিল্টার

Grid শিট, যা ডিফল্ট ধরণের শিট, এর বিদ্যমান ফিল্টারগুলি পরিবর্তন করতে এই ক্লাসটি ব্যবহার করুন। গ্রিড শিট হল নিয়মিত শিট যার ডেটা কোনও ডাটাবেসের সাথে সংযুক্ত নয়।

যদি শীটে এখনও কোনও ফিল্টার না থাকে, তাহলে Range.createFilter() ব্যবহার করে একটি তৈরি করুন।

এই ক্লাসটি ব্যবহার করার জন্য, আপনাকে প্রথমে Range.getFilter() অথবা Sheet.getFilter() ব্যবহার করে গ্রিড শিট ফিল্টার অ্যাক্সেস করতে হবে।

সাধারণ ব্যবহার

একটি ফিল্টার সরান

নিচের নমুনাটি সক্রিয় শীটে ফিল্টারটি পায় এবং এটি সরিয়ে দেয়। 
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Removes the filter from the active sheet.
filter.remove();

ফিল্টারটি যে পরিসরের উপর প্রযোজ্য তা পান

নিচের নমুনাটি সক্রিয় শিটে ফিল্টারটি পায়, তারপর ফিল্টারটি যে পরিসরের জন্য প্রযোজ্য তা লগ করতে এই ক্লাস থেকে get Range() পদ্ধতি ব্যবহার করে। 
const ss = SpreadsheetApp.getActiveSheet();
// Gets the existing filter on the active sheet.
const filter = ss.getFilter();
// Logs the range that the filter applies to in A1 notation.
console.log(filter.getRange().getA1Notation());

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
get Column Filter Criteria(columnPosition) Filter Criteria |null নির্দিষ্ট কলামে ফিল্টারের মানদণ্ড পায়, অথবা যদি কলামে ফিল্টারের মানদণ্ড প্রয়োগ না করা থাকে তবে null পায়।
get Range() Range এই ফিল্টারটি যে পরিসরে প্রযোজ্য তা পায়।
remove() void এই ফিল্টারটি সরিয়ে দেয়।
remove Column Filter Criteria(columnPosition) Filter নির্দিষ্ট কলাম থেকে ফিল্টারের মানদণ্ড সরিয়ে দেয়।
set Column Filter Criteria(columnPosition, filterCriteria) Filter নির্দিষ্ট কলামে ফিল্টারের মানদণ্ড নির্ধারণ করে।
sort(columnPosition, ascending) Filter এই ফিল্টারটি যে পরিসরে প্রযোজ্য তার প্রথম সারি (শিরোনাম সারি) বাদ দিয়ে, নির্দিষ্ট কলাম অনুসারে ফিল্টার করা পরিসরটি সাজায়।

বিস্তারিত ডকুমেন্টেশন

get Column Filter Criteria(columnPosition)

নির্দিষ্ট কলামে ফিল্টারের মানদণ্ড পায়, অথবা যদি কলামে ফিল্টারের মানদণ্ড প্রয়োগ না করা থাকে তবে null পায়।

ফিল্টারের মানদণ্ড সম্পর্কে আরও বিস্তারিত জানতে, এই পদ্ধতিটিকে Filter Criteria শ্রেণীর পদ্ধতিগুলির সাথে সংযুক্ত করুন।

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Gets the filter criteria applied to column B of the active sheet
// and logs the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
console.log(filterCriteria);

পরামিতি

নাম আদর্শ বিবরণ
column Position Integer কলামের ১-সূচক অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক হল ২।

প্রত্যাবর্তন

Filter Criteria |null — ফিল্টারের মানদণ্ড।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Range()

এই ফিল্টারটি যে পরিসরে প্রযোজ্য তা পায়।

// Gets the existing filter on the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Logs the range that the filter applies to in A1 notation.
console.log(filter.getRange().getA1Notation());

প্রত্যাবর্তন

Range — ফিল্টারের রেঞ্জ। A1 নোটেশনে রেঞ্জ পেতে, এই পদ্ধতিটিকে Range.getA1Notation() দিয়ে চেইন করুন।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

remove()

এই ফিল্টারটি সরিয়ে দেয়।

// Removes the filter from the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.remove();

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

remove Column Filter Criteria(columnPosition)

নির্দিষ্ট কলাম থেকে ফিল্টারের মানদণ্ড সরিয়ে দেয়।

// Removes the filter criteria from column B.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.removeColumnFilterCriteria(2);

পরামিতি

নাম আদর্শ বিবরণ
column Position Integer কলামের ১-সূচক অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক হল ২।

প্রত্যাবর্তন

Filter — চেইন লাগানোর জন্য ফিল্টার।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

set Column Filter Criteria(columnPosition, filterCriteria)

নির্দিষ্ট কলামে ফিল্টারের মানদণ্ড সেট করে। প্রথমে, Spreadsheet App.newFilterCriteria() ব্যবহার করে ফিল্টারের মানদণ্ড বিল্ডার তৈরি করুন। তারপর Filter Criteria Builder ক্লাস ব্যবহার করে বিল্ডারে মানদণ্ড যোগ করুন। আপনার মানদণ্ড তৈরি করার পরে, এটিকে এই পদ্ধতির জন্য filter Criteria প্যারামিটার হিসেবে সেট করুন।

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Builds the filter criteria to use as a parameter for setColumnFilterCriteria.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['Hello', 'World'])
                     .build();
// Sets the filter criteria for column C.
filter.setColumnFilterCriteria(3, criteria);

পরামিতি

নাম আদর্শ বিবরণ
column Position Integer কলামের ১-সূচক অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক হল ২।
filter Criteria Filter Criteria ফিল্টারের মানদণ্ড সেট করতে হবে। যদি আপনি মানদণ্ডটি null এ সেট করেন, তাহলে এটি নির্দিষ্ট কলাম থেকে ফিল্টারের মানদণ্ড সরিয়ে দেয়। আপনি remove Column Filter Criteria(columnPosition) ব্যবহার করতে পারেন।

প্রত্যাবর্তন

Filter — চেইন লাগানোর জন্য ফিল্টার।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

sort(columnPosition, ascending)

এই ফিল্টারটি যে পরিসরে প্রযোজ্য তার প্রথম সারি (শিরোনাম সারি) বাদ দিয়ে, নির্দিষ্ট কলাম অনুসারে ফিল্টার করা পরিসরটি সাজায়।

// Gets the existing filter and sorts it by column B in ascending order.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.sort(2, true);

পরামিতি

নাম আদর্শ বিবরণ
column Position Integer কলামের ১-সূচক অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক হল ২।
ascending Boolean যদি true , তাহলে ফিল্টার করা পরিসরটিকে ঊর্ধ্বক্রম অনুসারে সাজাবে; যদি false , তাহলে ফিল্টার করা পরিসরটিকে অবরোহক্রমে সাজাবে।

প্রত্যাবর্তন

Filter — চেইন লাগানোর জন্য ফিল্টার।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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