Class FilterCriteriaBuilder

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

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

الإرجاع

FilterCriteria — تمثيل لمعايير الفلتر.

تنسخ معايير الفلتر هذه وتنشئ أداة إنشاء معايير يمكنك تطبيقها على الفلتر.

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

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 — أداة إنشاء معايير الفلاتر استنادًا إلى معايير الفلتر هذه.

تعرض النوع المنطقي للمعايير، مثل CELL_EMPTY. للتعرف على أنواع من المعايير المنطقية، يمكنك الاطّلاع على التعداد BooleanCriteria.

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

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

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

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

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

لعرض القيم التي يخفيها الفلتر.

يمكنك استخدام هذه المعايير مع الفلاتر في 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[]: مصفوفة من القيم التي يخفيها الفلتر.

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

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

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

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

تعرض القيم التي يعرضها فلتر الجدول المحوري.

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

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

لضبط القيم المراد إخفاؤها. يؤدي هذا الإجراء إلى محو أي قيم حالية مرئية أو مخفية.

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

الرميات

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

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

تحدد القيم المراد عرضها على الجدول المحوري. يؤدي هذا الإجراء إلى محو أي قيم حالية مرئية أو مخفية.

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

// 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."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

الرميات

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

تضبط معايير الفلتر لإظهار الخلايا الفارغة.

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

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

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past month
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.PAST_MONTH;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let 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.
let formula = "=B:B<C:C";
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenFormulaSatisfied(formula)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

لضبط معايير الفلتر على شرط منطقي تحدده قيم 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();
let 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."
let filter = ss.getFilter();
let filterCriteria = filter.getColumnFilterCriteria(2);
let criteria = SpreadsheetApp.newFilterCriteria()
    .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues())
    .setHiddenValues(["Northwest"])
    .build();
filter.setColumnFilterCriteria(3, criteria);

المعلمات

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل