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 মানদণ্ডের বুলিয়ান প্রকার প্রদান করে, উদাহরণস্বরূপ, CELL_EMPTY
get Criteria Values() Object[] বুলিয়ান মানদণ্ডের জন্য আর্গুমেন্টের একটি বিন্যাস প্রদান করে।
get Hidden Values() String[] ফিল্টার লুকিয়ে থাকা মানগুলি ফেরত দেয়।
get Visible Background Color() Color ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত পটভূমির রঙ প্রদান করে।
get Visible Foreground Color() Color একটি ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত অগ্রভাগের রঙ প্রদান করে।
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 দেখুন।

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

  • মানদণ্ডের জন্য আর্গুমেন্ট পেতে, 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


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


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


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