Utilisez cette classe pour obtenir des informations sur les critères des filtres existants ou pour les copier.
- Pour créer un filtre, consultez les informations suivantes :
- Pour les feuilles, utilisez
Range.createFilter()
. - Pour les tableaux croisés dynamiques, utilisez
Pivot
.Table.addFilter(sourceDataColumn, filterCriteria) - Pour les feuilles connectées à une base de données, utilisez
Data
.Source Sheet.addFilter(columnName, filterCriteria) - Pour les tableaux croisés dynamiques connectés à une base de données, utilisez
Data
.Source Pivot Table.addFilter(columnName, filterCriteria)
- Pour les feuilles, utilisez
- Pour créer les critères de n'importe quel type de filtre, consultez
Spreadsheet
etApp.newFilterCriteria() Filter
.Criteria Builder
Utilisations courantes
Copier les critères
L'exemple suivant obtient le filtre qui s'applique à la plageA1:C20
, obtient les critères appliqués à la colonne C et copie les critères dans la colonne 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);
Obtenir les valeurs masquées par le filtre
L'exemple suivant obtient le filtre qui s'applique à la plage donnée et consigne les valeurs de la colonne B que le filtre masque.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);
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
copy() | Filter | Copier ces critères de filtre et créer un outil de création de critères que vous pouvez appliquer à un autre filtre |
get | Boolean | Renvoie le type booléen des critères, par exemple CELL_EMPTY . |
get | Object[] | Renvoie un tableau d'arguments pour les critères booléens. |
get | String[] | Renvoie les valeurs masquées par le filtre. |
get | Color | Affiche la couleur d'arrière-plan utilisée comme critère de filtrage. |
get | Color | Affiche la couleur de premier plan utilisée comme critère de filtrage. |
get | String[] | Renvoie les valeurs affichées par le filtre du tableau croisé dynamique. |
Documentation détaillée
copy()
Copier ces critères de filtre et créer un outil de création de critères que vous pouvez appliquer à un autre filtre
Vous pouvez utiliser cette méthode avec n'importe quel type de filtre. Si vous utilisez un filtre de feuille, vous pouvez copier les critères dans une autre colonne.
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);
Renvois
Filter
: outil de création de critères de filtrage basé sur ces critères.
get Criteria Type()
Renvoie le type booléen des critères, par exemple CELL_EMPTY
. Pour en savoir plus sur les types de critères booléens, consultez l'énumération Boolean
.
Cette méthode est souvent utilisée pour ajouter des critères de condition booléenne à un filtre sans remplacer les critères existants.
- Pour obtenir les arguments des critères, utilisez
get
.Criteria Values() - Pour utiliser le type et les valeurs de critères pour créer ou modifier des critères de filtrage, consultez la section
Filter
.Criteria Builder.withCriteria(criteria, args)
Vous pouvez utiliser cette méthode pour n'importe quel type de filtre. Si les critères de filtre ne sont pas une condition booléenne, renvoie 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);
Renvois
Boolean
: type de critères booléens, ou null
si les critères ne sont pas une condition booléenne.
get Criteria Values()
Renvoie un tableau d'arguments pour les critères booléens. Certains types de critères booléens n'ont pas d'arguments et renvoient un tableau vide, par exemple CELL_NOT_EMPTY
.
Cette méthode est souvent utilisée pour ajouter des critères de condition booléenne à un filtre sans remplacer les critères existants.
- Pour obtenir le type de critères booléens, utilisez
get
.Criteria Type() - Pour utiliser le type de critères et les valeurs de critères pour créer ou modifier des critères de filtrage, consultez la section
Filter
.Criteria Builder.withCriteria(criteria, args) Vous pouvez utiliser cette méthode pour n'importe quel type de filtre.
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);
Renvois
Object[]
: tableau d'arguments approprié au type de critères booléens. Le nombre d'arguments et leur type correspondent à la méthodewhen...()
correspondante de la classeFilter
.Criteria Builder
get Hidden Values()
Renvoie les valeurs masquées par le filtre.
Utilisez ce critère avec des filtres sur les feuilles Grid
, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Renvois
String[]
: tableau de valeurs masquées par le filtre.
get Visible Background Color()
Affiche la couleur d'arrière-plan utilisée comme critère de filtrage. Les cellules avec cette couleur d'arrière-plan restent visibles.
Utilisez ce critère avec des filtres sur des feuilles Grid
, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Renvois
Color
: couleur d'arrière-plan utilisée comme critère de filtrage.
get Visible Foreground Color()
Affiche la couleur de premier plan utilisée comme critère de filtrage. Les cellules de cette couleur de premier plan restent visibles.
Utilisez ce critère avec des filtres sur les feuilles Grid
, le type de feuille par défaut.
Renvoie null
si vous appelez cette méthode pour d'autres types de filtres.
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);
Renvois
Color
: couleur de premier plan utilisée comme critère de filtrage.
get Visible Values()
Renvoie les valeurs affichées par le filtre du tableau croisé dynamique.
Ce critère ne s'applique qu'aux filtres des tableaux croisés dynamiques qui ne sont pas connectés à une base de données. Renvoie un tableau vide pour les autres types de filtres.
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);
Renvois
String[]
: tableau de valeurs affiché par le filtre du tableau croisé dynamique.