تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class FilterCriteriaBuilder

أداة إنشاء معايير الفلتر لإضافة معايير إلى فلتر، عليك اتّباع الخطوات التالية:

أنشئ أداة إنشاء المعايير باستخدام SpreadsheetApp.newFilterCriteria().
أضِف الإعدادات إلى أداة الإنشاء باستخدام الطرق الواردة في هذه الفئة.
استخدِم build() لتجميع المعايير مع الإعدادات المحدّدة.

طرق الاستخدام الشائعة

إخفاء القيم في ورقة بيانات

يحصل النموذج التالي على فلتر حالي في ورقة البيانات ويضيف معايير تخفي الخلايا في عمود C التي تحتوي على "مرحبًا" أو "عالم". لا يمكن استخدام المعايير الواردة في هذا العيّنة إلا مع الفلاتر في أوراق بيانات Grid، وهو النوع التلقائي لأوراق البيانات.

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

عرض الخلايا غير الفارغة فقط

يضيف النموذج التالي فلترًا إلى ورقة بيانات DataSource، وهي ورقة بيانات مرتبطة بقاعدة بيانات، مع معايير تعرِض فقط الخلايا في عمود "الفئة" التي ليست فارغة.

// Gets the sheet named "Connected sheet," which is connected to a database.
const sheet = SpreadsheetApp.getActiveSpreadsheet()
                  .getSheetByName('Connected sheet')
                  .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
// Applies the criteria to the column named "Category."
sheet.addFilter('Category', criteria);

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`build()`	`FilterCriteria`	تُجمِّع معايير الفلتر باستخدام الإعدادات التي تضيفها إلى أداة إنشاء المعايير.
`copy()`	`FilterCriteriaBuilder`	نسخ معايير هذا الفلتر وإنشاء أداة إنشاء معايير يمكنك تطبيقها على فلتر آخر
`getCriteriaType()`	`BooleanCriteria`	تعرِض هذه الدالة نوع المعايير المنطقي، على سبيل المثال، `CELL_EMPTY`.
`getCriteriaValues()`	`Object[]`	لعرض صفيف من الوسيطات للمعايير المنطقية.
`getHiddenValues()`	`String[]`	عرض القيم التي يخفيها الفلتر
`getVisibleBackgroundColor()`	`Color`	عرض لون الخلفية المستخدَم كمعايير فلترة
`getVisibleForegroundColor()`	`Color`	تعرِض هذه الدالة لون المقدّمة المستخدَم كمعايير فلترة.
`getVisibleValues()`	`String[]`	لعرض القيم التي يعرضها فلتر الجدول المحوري
`setHiddenValues(values)`	`FilterCriteriaBuilder`	تُستخدَم لضبط القيم المطلوب إخفاؤها.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	لضبط لون الخلفية المستخدَم كمعيار فلترة
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	لضبط لون المقدّمة المستخدَم كمعايير فلترة
`setVisibleValues(values)`	`FilterCriteriaBuilder`	لضبط القيم التي سيتم عرضها في جدول محوري
`whenCellEmpty()`	`FilterCriteriaBuilder`	لضبط معايير الفلتر لعرض الخلايا الفارغة
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا غير الفارغة.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ بعد التاريخ المحدّد.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ لاحقة للتاريخ النسبي المحدّد.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر التي تعرِض الخلايا التي تحتوي على تواريخ قبل التاريخ المحدّد.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ قبل التاريخ النسبي المحدّد.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ مساوية للتاريخ المحدّد.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ تساوي التاريخ النسبي المحدّد.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة من أجل عرض الخلايا التي تحتوي على تواريخ تساوي أيًا من التواريخ المحدّدة.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي لا تساوي التاريخ المحدّد.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على تواريخ غير مساوية لأي من تواريخ التي تم تحديدها.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	لضبط معايير الفلترة لعرض الخلايا التي تحتوي على صيغة محدّدة (مثل `=B:B<C:C`) تؤدي إلى `true`
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يقع بين رقمين محدّدين أو يكون أحدهما.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم يساوي الرقم المحدّد.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يساوي أيًا من الأرقام المحدّدة
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	تضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدّد.
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم أكبر من أو يساوي الرقم المحدّد
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أقل من الرقم المحدّد.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أقل من أو يساوي الرقم المحدَّد.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم لا يقع بين رقمين محدّدين ولا يمثّل أيًا منهما.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم غير مساوي للرقم المحدّد.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم غير مساوي لأي من الأرقام المحدّدة.
`whenTextContains(text)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يتضمّن النص المحدّد.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على نص لا يتضمّن النص المحدّد.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص ينتهي بالنص المحدّد
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	لضبط معايير الفلتر لعرض الخلايا التي تحتوي على نص يساوي النص المحدّد
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي أيًا من قيم النص المُحدّدة.
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص غير مساوي للنص المحدّد
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص غير مساوي لأيٍّ من القيمة المحدّدة.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يبدأ بالنص المحدّد
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	لضبط معايير الفلتر على شرط منطقي محدّد بقيم `BooleanCriteria`، مثل `CELL_EMPTY` أو `NUMBER_GREATER_THAN`.

مستندات تفصيلية

`build()`

تُجمِّع معايير الفلتر باستخدام الإعدادات التي تضيفها إلى أداة إنشاء المعايير.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp
                     .newFilterCriteria()  // Creates a criteria builder.
                     .whenCellNotEmpty()   // Adds settings to the builder.
                     .build();             // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

الإرجاع

FilterCriteria: تمثيل لمعايير الفلتر

`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.

غالبًا ما يستخدم الأشخاص هذه الطريقة لإضافة معايير شرطية منطقية إلى فلتر بدون استبدال المعايير الحالية.

للحصول على الوسيطات للمعايير، استخدِم getCriteriaValues().
لاستخدام نوع المعايير وقيم المعايير لإنشاء معايير الفلتر أو تعديلها، اطّلِع على 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 إذا لم تكن المعايير شرطًا منطقيًا

`getCriteriaValues()`

لعرض صفيف من الوسيطات للمعايير المنطقية. لا تحتوي بعض أنواع المعايير المنطقية على وسيطات وتُعرِض صفيفًا فارغًا، على سبيل المثال، CELL_NOT_EMPTY.

غالبًا ما يستخدم الأشخاص هذه الطريقة لإضافة معايير شرطية منطقية إلى فلتر بدون استبدال المعايير الحالية.

للحصول على نوع المعايير المنطقية، استخدِم getCriteriaType().
لاستخدام نوع المعايير وقيم المعايير لإنشاء معايير فلتر أو تعديلها، اطّلِع على 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[]: صفيف من الوسيطات المناسبة لنوع المعايير المنطقية يتطابق عدد الوسيطات ونوعها مع طريقة when...() المقابلة لفئة FilterCriteriaBuilder.

`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()`

عرض لون الخلفية المستخدَم كمعايير فلترة تظل الخلايا التي تتضمّن لون الخلفية هذا مرئية.

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: لون الخلفية المستخدَم كمعايير فلترة

`getVisibleForegroundColor()`

تعرِض هذه الدالة لون المقدّمة المستخدَم كمعايير فلترة. تظل الخلايا التي تتضمّن لون المقدّمة هذا مرئية.

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: لون المقدّمة المستخدَم كمعايير فلترة

`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[]: صفيف من القيم التي يعرضها فلتر الجدول المحوري

`setHiddenValues(values)`

تُستخدَم لضبط القيم المطلوب إخفاؤها. تمحو أي قيم حالية مرئية أو مخفية.

لا يمكنك استخدام هذه المعايير إلا للفلاتر في أوراق البيانات من النوع Grid، وهو النوع الافتراضى للورقة.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['Hello', 'World'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

المعلمات

الاسم	النوع	الوصف
`values`	`String[]`	قائمة القيم المطلوب إخفاؤها

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

عمليات الرمي

Error - إذا كانت أي من القيم هي null.

`setVisibleBackgroundColor(visibleBackgroundColor)`

لضبط لون الخلفية المستخدَم كمعيار فلترة تظل الخلايا التي تتضمّن لون الخلفية هذا مرئية. يؤدي ضبط معايير فلتر لون الخلفية إلى إزالة أي معايير حالية لفلترة الألوان من هذا المُنشئ.

لا يمكنك استخدام هذه المعايير إلا للفلاتر في أوراق البيانات من النوع Grid، وهو النوع الافتراضى للورقة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const criteria =
    SpreadsheetApp.newFilterCriteria().setVisibleBackgroundColor(color).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`visibleBackgroundColor`	`Color`	لون الخلفية المطلوب ضبطه. يجب أن يكون اللون من أسلوب RGB. لا تتيح هذه الطريقة استخدام ألوان المظهر.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`setVisibleForegroundColor(visibleForegroundColor)`

لضبط لون المقدّمة المستخدَم كمعايير فلترة تظل الخلايا التي تتضمّن لون المقدّمة هذا مرئية. يؤدي ضبط معايير فلتر لون المقدّمة إلى إزالة أي معايير حالية لفلترة اللون من هذا المُنشئ.

لا يمكنك استخدام هذه المعايير إلا للفلاتر في أوراق بيانات Grid، وهي نوع الجدول الزمني الافتراضية.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const criteria =
    SpreadsheetApp.newFilterCriteria().setVisibleForegroundColor(color).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`visibleForegroundColor`	`Color`	لون المقدّمة المطلوب ضبطه. يجب أن يكون اللون من أسلوب RGB. لا تتيح هذه الطريقة استخدام ألوان المظهر.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`setVisibleValues(values)`

لضبط القيم التي سيتم عرضها في جدول محوري تمحو أي قيم حالية مرئية أو مخفية.

لا يمكنك استخدام هذه المعايير إلا للفلاتر في الجداول المحورية غير المرتبطة بقاعدة بيانات.

// Gets the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet and adds a filter to it that
// sets the visible values to "Northeast" and "Southwest."
const pivotTable = ss.getPivotTables()[0];
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setVisibleValues(['Northeast', 'Southwest'])
                     .build();
pivotTable.addFilter(2, criteria);

المعلمات

الاسم	النوع	الوصف
`values`	`String[]`	قائمة القيم المطلوب عرضها

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

عمليات الرمي

Error - إذا كانت أي من القيم هي null.

`whenCellEmpty()`

لضبط معايير الفلتر لعرض الخلايا الفارغة

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenCellNotEmpty()`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا غير الفارغة.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenDateAfter(date)`

تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ بعد التاريخ المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدِم هذه المعايير مع بيانات مرتبطة بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تتم الفلترة حسبه تاريخًا. إذا كانت البيانات غير متصلة بقاعدة بيانات، ليس من الضروري أن يكون نوع بيانات العمود الذي يتمّ الفلترة حسبه تاريخًا، ولكن إذا لم يكن كذلك، قد تحصل على نتائج غير متوقّعة.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria = SpreadsheetApp.newFilterCriteria().whenDateAfter(date).build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`Date`	آخر تاريخ للإخفاء.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenDateAfter(date)`

تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ لاحقة للتاريخ النسبي المحدّد. لاطلاع على خيارات التاريخ النسبي، يُرجى الرجوع إلى Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`RelativeDate`	أحدث تاريخ نسبي.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenDateBefore(date)`

تُستخدَم لضبط معايير الفلتر التي تعرِض الخلايا التي تحتوي على تواريخ قبل التاريخ المحدّد.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateBefore(date).build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`Date`	أقرب تاريخ للإخفاء.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenDateBefore(date)`

تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ قبل التاريخ النسبي المحدّد. للاطّلاع على خيارات التاريخ النسبي، يُرجى الرجوع إلى Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`RelativeDate`	أقرب تاريخ نسبي لإخفائه.

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenDateEqualTo(date)`

تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ مساوية للتاريخ المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدِم هذه المعايير مع بيانات مرتبطة بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تتم الفلترة حسبه تاريخًا. إذا كانت البيانات غير متصلة بقاعدة بيانات، ليس بالضرورة أن يكون نوع بيانات العمود الذي يتمّ الفلترة حسبه تاريخًا، ولكن إذا لم يكن كذلك، قد تحصل على نتائج غير متوقّعة.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateEqualTo(date).build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`Date`	التاريخ الذي يجب أن تتطابق معه قيم الخلايا.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenDateEqualTo(date)`

تُستخدَم لضبط معايير الفلترة التي تعرِض الخلايا التي تحتوي على تواريخ تساوي التاريخ النسبي المحدّد. للاطّلاع على خيارات التاريخ النسبي، يُرجى الرجوع إلى Enum RelativeDate.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`RelativeDate`	التاريخ النسبي الذي يجب أن تتطابق معه قيم الخلايا.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenDateEqualToAny(dates)`

تُستخدَم لضبط معايير الفلترة من أجل عرض الخلايا التي تحتوي على تواريخ تساوي أيًا من التواريخ المحدّدة.

لا يمكنك استخدام هذه المعايير إلا مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدِم هذه المعايير مع الفلاتر في ورقة بيانات DataSource أو ورقة بيانات مرتبطة بقاعدة بيانات أو DataSourcePivotTable، وهو جدول محوري تم إنشاؤه من ورقة بيانات DataSource.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

المعلمات

الاسم	النوع	الوصف
`dates`	`Date[]`	التواريخ المطلوب عرضها

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenDateNotEqualTo(date)`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي لا تساوي التاريخ المحدّد.

يجب أن يكون نوع بيانات العمود الذي يتم الفلترة حسبه تاريخًا.

// Gets a pivot table that's connected to a database.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateNotEqualTo(date).build();
dataPivotTable.addFilter('date', criteria);

المعلمات

الاسم	النوع	الوصف
`date`	`Date`	التاريخ المطلوب إخفاؤه

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenDateNotEqualToAny(dates)`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على تواريخ غير مساوية لأي من تواريخ التي تم تحديدها.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateNotEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

المعلمات

الاسم	النوع	الوصف
`dates`	`Date[]`	التواريخ المطلوب إخفاؤها

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenFormulaSatisfied(formula)`

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على صيغة محدّدة (مثل =B:B<C:C) تؤدي إلى true

لا يمكنك استخدام هذه المعايير إلا لفلترة البيانات غير المرتبطة بقاعدة بيانات.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows the rows where the value in column B is less than
// the value in column C and sets it to column A.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`formula`	`String`	صيغة مخصّصة يتم تقييمها على أنّها `true` إذا كان الإدخال صالحًا.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenNumberBetween(start, end)`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يقع بين رقمين محدّدين أو يكون أحدهما.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات مرتبطة بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تتم الفلترة حسبه رقمًا. إذا كانت البيانات غير متصلة بقاعدة بيانات، ليس من الضروري أن يكون نوع بيانات العمود الذي يتم الفلترة حسبه رقمًا، ولكن إذا لم يكن كذلك، قد تحصل على نتائج غير متوقّعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25,
// inclusively, and sets it to column A.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberBetween(1, 25).build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسم	النوع	الوصف
`start`	`Number`	أدنى عدد يمكن عرضه.
`end`	`Number`	أكبر عدد يمكن عرضه.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenNumberEqualTo(number)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم يساوي الرقم المحدّد.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	الرقم المطلوب عرضه.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenNumberEqualToAny(numbers)`

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يساوي أيًا من الأرقام المحدّدة

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number
// 10, 20, or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

المعلمات

الاسم	النوع	الوصف
`numbers`	`Number[]`	الأرقام المطلوب عرضها

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenNumberGreaterThan(number)`

تضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدِم هذه المعايير مع بيانات مرتبطة بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تتم الفلترة حسبه رقمًا. إذا كانت البيانات غير متصلة بقاعدة بيانات، ليس من الضروري أن يكون نوع بيانات العمود الذي يتم الفلترة حسبه رقمًا، ولكن إذا لم يكن كذلك، قد تحصل على نتائج غير متوقّعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberGreaterThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	أكبر عدد يمكن إخفاؤه.

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenNumberGreaterThanOrEqualTo(number)`

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم أكبر من أو يساوي الرقم المحدّد

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to
// column B.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberGreaterThanOrEqualTo(10)
                     .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	أدنى عدد يمكن عرضه.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenNumberLessThan(number)`

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أقل من الرقم المحدّد.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	أدنى عدد لإخفائه

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenNumberLessThanOrEqualTo(number)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أقل من أو يساوي الرقم المحدَّد.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThanOrEqualTo(10).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	أكبر عدد يمكن عرضه.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenNumberNotBetween(start, end)`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم لا يقع بين رقمين محدّدين ولا يمثّل أيًا منهما.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25,
// inclusively, and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotBetween(1, 25).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`start`	`Number`	يتم إخفاء أقل عدد.
`end`	`Number`	أكبر عدد يمكن إخفاؤه.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenNumberNotEqualTo(number)`

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم غير مساوي للرقم المحدّد.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column
// B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	الرقم المطلوب إخفاؤه.

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenNumberNotEqualToAny(numbers)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم غير مساوي لأي من الأرقام المحدّدة.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20,
// or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberNotEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

المعلمات

الاسم	النوع	الوصف
`numbers`	`Number[]`	الأرقام المطلوب إخفاؤها

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenTextContains(text)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يتضمّن النص المحدّد. النص ليس حسّاسًا لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextContains('Northwest').build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي يجب أن تحتوي عليه الخلية.

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenTextDoesNotContain(text)`

تُستخدَم لضبط معايير الفلتر لعرض الخلايا التي تحتوي على نص لا يتضمّن النص المحدّد. النص غير حسّاس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to
// column B.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextDoesNotContain('Northwest')
                     .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي يجب ألا تحتوي عليه الخلية.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenTextEndsWith(text)`

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص ينتهي بالنص المحدّد النص ليس حسّاسًا لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEndsWith('est').build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي يجب أن يحتوي عليه نص الخلية في نهايته

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لإنشاء سلسلة.

`whenTextEqualTo(text)`

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على نص يساوي النص المحدّد النص ليس حسّاسًا لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEqualTo('hello').build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي يجب أن يساويه نص الخلية.

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenTextEqualToAny(texts)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي أيًا من قيم النص المُحدّدة. النص غير حسّاس لحالة الأحرف.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

المعلمات

الاسم	النوع	الوصف
`texts`	`String[]`	القيم النصية التي يجب أن تساويها الخلية

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenTextNotEqualTo(text)`

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص غير مساوي للنص المحدّد النص غير حسّاس لحالة الأحرف.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي لا يمكن أن يساويه نص الخلية

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.

`whenTextNotEqualToAny(texts)`

تُستخدَم لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص غير مساوي لأيٍّ من القيمة المحدّدة. النص غير حسّاس لحالة الأحرف.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextNotEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

المعلمات

الاسم	النوع	الوصف
`texts`	`String[]`	قيم النصوص التي لا يمكن أن تساويها الخلية

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`whenTextStartsWith(text)`

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يبدأ بالنص المحدّد النص غير حسّاس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets
// it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextStartsWith('pre').build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسم	النوع	الوصف
`text`	`String`	النص الذي يجب أن يحتوي عليه نص الخلية في بدايته

الإرجاع

FilterCriteriaBuilder: هذا المُنشئ، لتسلسل العناصر.

`withCriteria(criteria, args)`

لضبط معايير الفلتر على شرط منطقي محدّد بقيم BooleanCriteria، مثل CELL_EMPTY أو NUMBER_GREATER_THAN. لنسخ الشرط المنطقي من المعايير الحالية، حدِّد مَعلمات لهذه الطريقة باستخدام getCriteriaType() وgetCriteriaValues() في المعايير الحالية.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر، ولكن بعض BooleanCriteria لا تُطبَّق على جميع الفلاتر.

// Builds a filter criteria that is based on existing boolean conditions from
// another criteria. Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to
// column C that has the same boolean conditions and additional criteria that
// hides the value, "Northwest."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

المعلمات

الاسم	النوع	الوصف
`criteria`	`BooleanCriteria`	نوع المعايير المنطقية
`args`	`Object[]`	صفيف من الوسيطات المناسبة لنوع المعايير، ويتطابق عدد الوسيطات و نوعها مع طرق `when...()` المقابلة أعلاه.

الإرجاع

FilterCriteriaBuilder - هذا المُنشئ، لتسلسل العناصر.