Class FilterCriteria

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

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

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

কপি মানদণ্ড

নিম্নলিখিত নমুনাটি ফিল্টার পায় যা A1:C20 পরিসরে প্রযোজ্য, কলাম C-তে প্রয়োগের মানদণ্ড পায়, এবং কলাম B-এ মানদণ্ড অনুলিপি করে।
let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Copies the filter criteria applied to column C.
let filter = range.getFilter();
let 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 থেকে মানগুলি লগ করে যা ফিল্টারটি লুকিয়ে রাখে।
let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
copy() FilterCriteriaBuilder এই ফিল্টার মানদণ্ড অনুলিপি করে এবং একটি মানদণ্ড নির্মাতা তৈরি করে যা আপনি অন্য ফিল্টারে প্রয়োগ করতে পারেন।
getCriteriaType() BooleanCriteria মানদণ্ডের বুলিয়ান প্রকার প্রদান করে, উদাহরণস্বরূপ, CELL_EMPTY
getCriteriaValues() Object[] বুলিয়ান মানদণ্ডের জন্য আর্গুমেন্টের একটি বিন্যাস প্রদান করে।
getHiddenValues() String[] ফিল্টার লুকিয়ে থাকা মানগুলি ফেরত দেয়।
getVisibleBackgroundColor() Color ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত পটভূমির রঙ প্রদান করে।
getVisibleForegroundColor() Color একটি ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত অগ্রভাগের রঙ প্রদান করে।
getVisibleValues() String[] পিভট টেবিল ফিল্টার যে মানগুলি দেখায় সেগুলি প্রদান করে৷

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

copy()

এই ফিল্টার মানদণ্ড অনুলিপি করে এবং একটি মানদণ্ড নির্মাতা তৈরি করে যা আপনি অন্য ফিল্টারে প্রয়োগ করতে পারেন।

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

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
let 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 প্রদান করে।

let ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
let filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type object.
let criteriaType = filter.getColumnFilterCriteria(2)
                         .getCriteriaType()
                         .toString();
// Logs the criteria type.
console.log(criteriaType);

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

BooleanCriteria — বুলিয়ান মানদণ্ডের ধরন, বা মানদণ্ডটি বুলিয়ান শর্ত না হলে null


getCriteriaValues()

বুলিয়ান মানদণ্ডের জন্য আর্গুমেন্টের একটি বিন্যাস প্রদান করে। কিছু বুলিয়ান মানদণ্ডের ধরণে আর্গুমেন্ট থাকে না এবং একটি খালি অ্যারে ফেরত দেয়, উদাহরণস্বরূপ, CELL_NOT_EMPTY

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

  • বুলিয়ান মানদণ্ডের ধরন পেতে, getCriteriaType() ব্যবহার করুন।
  • একটি ফিল্টার মানদণ্ড তৈরি বা সংশোধন করতে মানদণ্ডের ধরন এবং মানদণ্ডের মানগুলি ব্যবহার করতে, দেখুন FilterCriteriaBuilder.withCriteria(criteria, args)

    আপনি যে কোনো ধরনের ফিল্টার জন্য এই পদ্ধতি ব্যবহার করতে পারেন.

    let ss = SpreadsheetApp.getActiveSheet();
    let 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.
    let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
    console.log(criteriaValues);

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

    Object[] — বুলিয়ান মানদণ্ডের প্রকারের জন্য উপযুক্ত আর্গুমেন্টের একটি বিন্যাস। FilterCriteriaBuilder ক্লাসের আর্গুমেন্টের সংখ্যা এবং তাদের ধরন সংশ্লিষ্ট when...() পদ্ধতির সাথে মেলে।


getHiddenValues()

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

Grid শীটে ফিল্টার সহ এই মানদণ্ডটি ব্যবহার করুন, শীটের ডিফল্ট প্রকার৷ অন্য ধরনের ফিল্টারের জন্য আপনি এই পদ্ধতিটিকে কল করলে null ফেরত দেয়।

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

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

String[] — ফিল্টার লুকিয়ে থাকা মানগুলির একটি অ্যারে।


getVisibleBackgroundColor()

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

Grid শীটে ফিল্টার সহ এই মানদণ্ডটি ব্যবহার করুন, শীটের ডিফল্ট প্রকার৷ অন্য ধরনের ফিল্টারের জন্য আপনি এই পদ্ধতিটিকে কল করলে null ফেরত দেয়।

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the background color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

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

Color — ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত পটভূমির রঙ।


getVisibleForegroundColor()

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

Grid শীটে ফিল্টার সহ এই মানদণ্ডটি ব্যবহার করুন, শীটের ডিফল্ট প্রকার৷ অন্য ধরনের ফিল্টারের জন্য আপনি এই পদ্ধতিটিকে কল করলে null ফেরত দেয়।

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the foreground color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

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

Color - একটি ফিল্টার মানদণ্ড হিসাবে ব্যবহৃত অগ্রভাগের রঙ।


getVisibleValues()

পিভট টেবিল ফিল্টার যে মানগুলি দেখায় সেগুলি প্রদান করে৷

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

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

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

String[] — মানগুলির একটি অ্যারে যা পিভট টেবিল ফিল্টার দেখায়।