Class FilterCriteria

Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur filtresini uygulayabilirsiniz.

Bu yöntemi tüm filtre türleriyle kullanabilirsiniz. Sayfa filtresi kullanıyorsanız şunları yapabilirsiniz: ölçütleri başka bir sütuna kopyalayın.

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);

Return

FilterCriteriaBuilder — Bu filtre ölçütlerini temel alan bir filtre ölçütü oluşturucu.

Ölçütlerin boole türünü döndürür (ör. CELL_EMPTY). Türler hakkında bilgi edinmek için Boole ölçütü için BooleanCriteria sıralamasına bakın.

Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.

• Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() işlevini kullanın.
• Filtre ölçütleri oluşturmak veya mevcut filtreleri değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın: FilterCriteriaBuilder.withCriteria(criteria, args)

Bu yöntemi tüm filtre türleri için kullanabilirsiniz. Filtre ölçütleri bir boole değeri değilse koşul, null değerini döndürür.

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);

Return

BooleanCriteria — Boole ölçütlerinin türü veya ölçütler bir boole değilse null koşul.

Boole ölçütleri için bir bağımsız değişken dizisi döndürür. Bazı boole ölçüt türleri bağımsız değişkenlerini içerir ve boş bir dizi döndürür (örneğin, CELL_NOT_EMPTY).

Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.

• Boole ölçüt türünü almak için getCriteriaType() işlevini kullanın.
• Filtre ölçütleri oluşturmak veya mevcut bir filtre ölçütünü değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın: FilterCriteriaBuilder.withCriteria(criteria, args)

  Bu yöntemi tüm filtre türleri için kullanabilirsiniz.

  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);

  Return

  Object[] — Boole ölçüt türüne uygun bir bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü, FilterCriteriaBuilder sınıfının ilgili when...() yöntemiyle eşleşmelidir.

Filtrenin gizlediği değerleri döndürür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null değerini döndürür.

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);

Return

String[]: Filtrenin gizlediği bir değer dizisi.

Filtre ölçütü olarak kullanılan arka plan rengini döndürür. Bu arka plan rengine sahip hücreler kalır görünür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null değerini döndürür.

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);

Return

Color — Filtre ölçütü olarak kullanılan arka plan rengi.

Filtre ölçütü olarak kullanılan ön plan rengini döndürür. Ön plan rengi bu renkte olan hücreler kaldı görünür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null değerini döndürür.

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);

Return

Color — Filtre ölçütü olarak kullanılan ön plan rengi.

Pivot tablo filtresinin gösterdiği değerleri döndürür.

Bu ölçüt yalnızca bir veritabanına bağlı olmayan pivot tablolardaki filtreler içindir. Diğer filtre türleri için boş bir dizi döndürür.

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);

Return

String[]: Pivot tablo filtresinin gösterdiği değerler dizisi.