Class FilterCriteria

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

বিদ্যমান ফিল্টারগুলোর শর্তাবলি সম্পর্কে তথ্য পেতে বা কপি করতে এই ক্লাসটি ব্যবহার করুন।

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

মানদণ্ড অনুলিপি করুন

নিম্নলিখিত নমুনাটি 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);

ফেরত

FilterCriteriaBuilder — এই ফিল্টার ক্রাইটেরিয়ার উপর ভিত্তি করে তৈরি একটি ফিল্টার ক্রাইটেরিয়া বিল্ডার।

getCriteriaType()

ক্রাইটেরিয়ার বুলিয়ান টাইপ রিটার্ন করে, যেমন, CELL_EMPTY । বুলিয়ান ক্রাইটেরিয়ার প্রকারভেদ সম্পর্কে জানতে BooleanCriteria enum-টি দেখুন।

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

  • ক্রাইটেরিয়ার আর্গুমেন্টগুলো পেতে getCriteriaValues() ব্যবহার করুন।
  • ক্রাইটেরিয়া টাইপ এবং ক্রাইটেরিয়া ভ্যালু ব্যবহার করে ফিল্টার ক্রাইটেরিয়া তৈরি বা পরিবর্তন করতে, FilterCriteriaBuilder.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);

ফেরত

BooleanCriteria |null — বুলিয়ান ক্রাইটেরিয়ার ধরণ, অথবা ক্রাইটেরিয়াটি বুলিয়ান শর্ত না হলে null ।

getCriteriaValues()

বুলিয়ান শর্তের জন্য আর্গুমেন্টের একটি অ্যারে ফেরত দেয়। কিছু বুলিয়ান শর্তের কোনো আর্গুমেন্ট থাকে না এবং সেগুলো একটি খালি অ্যারে ফেরত দেয়, যেমন, CELL_NOT_EMPTY ।

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

  • বুলিয়ান ক্রাইটেরিয়া টাইপ জানতে getCriteriaType() ব্যবহার করুন।
  • ক্রাইটেরিয়ার ধরন এবং মান ব্যবহার করে ফিল্টার ক্রাইটেরিয়া তৈরি বা পরিবর্তন করতে, FilterCriteriaBuilder.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[] — বুলিয়ান ক্রাইটেরিয়া টাইপের জন্য উপযুক্ত আর্গুমেন্টের একটি অ্যারে। আর্গুমেন্টের সংখ্যা এবং তাদের টাইপ FilterCriteriaBuilder ক্লাসের সংশ্লিষ্ট when...() মেথডের সাথে মেলে।

getHiddenValues()

ফিল্টার দ্বারা লুকানো মানগুলো ফেরত দেয়।

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[] — মানগুলির একটি অ্যারে যা ফিল্টারটি লুকায়।

getVisibleBackgroundColor()

ফিল্টার শর্ত হিসেবে ব্যবহৃত ব্যাকগ্রাউন্ড রঙটি ফেরত দেয়। এই ব্যাকগ্রাউন্ড রঙের সেলগুলো দৃশ্যমান থাকে।

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 — ফিল্টার মানদণ্ড হিসেবে ব্যবহৃত পটভূমির রঙ।

getVisibleForegroundColor()

ফিল্টার শর্ত হিসেবে ব্যবহৃত ফোরগ্রাউন্ড রঙটি ফেরত দেয়। এই ফোরগ্রাউন্ড রঙের সেলগুলো দৃশ্যমান থাকে।

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 — ফিল্টার মানদণ্ড হিসেবে ব্যবহৃত অগ্রভাগের রঙ।

getVisibleValues()

পিভট টেবিল ফিল্টার যে মানগুলো দেখায়, সেগুলো ফেরত দেয়।

এই শর্তটি শুধুমাত্র সেইসব পিভট টেবিলের ফিল্টারের জন্য প্রযোজ্য, যেগুলো কোনো ডেটাবেসের সাথে সংযুক্ত নয়। অন্যান্য ধরনের ফিল্টারের জন্য এটি একটি খালি অ্যারে ফেরত দেয়।

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[] — মানগুলির একটি অ্যারে যা পিভট টেবিল ফিল্টারটি দেখায়।