Class Filter

ফিল্টার

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

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

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

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

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

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

ফিল্টার প্রযোজ্য পরিসীমা পান

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

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
getColumnFilterCriteria(columnPosition) FilterCriteria নির্দিষ্ট কলামে ফিল্টার মানদণ্ড পায়, অথবা যদি কলামটিতে ফিল্টার মানদণ্ড প্রয়োগ করা না থাকে তাহলে null
getRange() Range এই ফিল্টারটি প্রযোজ্য পরিসর পায়।
remove() void এই ফিল্টার সরান.
removeColumnFilterCriteria(columnPosition) Filter নির্দিষ্ট কলাম থেকে ফিল্টার মানদণ্ড সরিয়ে দেয়।
setColumnFilterCriteria(columnPosition, filterCriteria) Filter নির্দিষ্ট কলামে ফিল্টার মানদণ্ড সেট করে।
sort(columnPosition, ascending) Filter এই ফিল্টারটি প্রযোজ্য পরিসরের প্রথম সারি (শিরোনাম সারি) বাদ দিয়ে নির্দিষ্ট কলাম দ্বারা ফিল্টার করা পরিসরকে সাজায়৷

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

getColumnFilterCriteria(columnPosition)

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

ফিল্টার মানদণ্ড সম্পর্কে আরও বিশদ পেতে, FilterCriteria ক্লাসের পদ্ধতিগুলির সাথে এই পদ্ধতিটি চেইন করুন।

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

পরামিতি

নাম টাইপ বর্ণনা
columnPosition Integer কলামের 1-সূচীকৃত অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক 2।

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

FilterCriteria - ফিল্টার মানদণ্ড।

অনুমোদন

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

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

getRange()

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

// Gets the existing filter on the active sheet.
let ss = SpreadsheetApp.getActiveSheet();
let 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.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
filter.remove();

অনুমোদন

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

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

removeColumnFilterCriteria(columnPosition)

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

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

পরামিতি

নাম টাইপ বর্ণনা
columnPosition Integer কলামের 1-সূচীকৃত অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক 2।

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

Filter - ফিল্টার, চেইনিংয়ের জন্য।

অনুমোদন

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

let ss = SpreadsheetApp.getActiveSheet();
let 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);

পরামিতি

নাম টাইপ বর্ণনা
columnPosition Integer কলামের 1-সূচীকৃত অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক 2।
filterCriteria FilterCriteria ফিল্টারের মানদণ্ড সেট করতে হবে। আপনি মানদণ্ডটি null এ সেট করলে, এটি নির্দিষ্ট কলাম থেকে ফিল্টার মানদণ্ড সরিয়ে দেয়। এছাড়াও আপনি removeColumnFilterCriteria(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.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
filter.sort(2, true);

পরামিতি

নাম টাইপ বর্ণনা
columnPosition Integer কলামের 1-সূচীকৃত অবস্থান। উদাহরণস্বরূপ, কলাম B এর সূচক 2।
ascending Boolean true হলে, ফিল্টার করা পরিসরকে আরোহী ক্রমে সাজায়; false হলে, ফিল্টার করা পরিসরকে নিচের ক্রমে সাজায়।

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

Filter - ফিল্টার, চেইনিংয়ের জন্য।

অনুমোদন

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

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