Excel.FilterCriteria interface
Representa los criterios de filtrado que se aplican a una columna.
Comentarios
[ Conjunto de API: ExcelApi 1.2 ]
Propiedades
color | Cadena de color HTML que se usa para filtrar las celdas. Se usa con |
criterion1 | Primer criterio usado para filtrar los datos. Se usa como operador en el caso de Se usa como número en el caso de los elementos/porcentajes superior/inferior (por ejemplo, "5" para los 5 elementos principales si |
criterion2 | Segundo criterio usado para filtrar los datos. Solo se usa como operador en el caso de |
dynamic |
Criterios dinámicos del |
filter |
Propiedad usada por el filtro para determinar si los valores deben permanecer visibles. |
icon | Icono usado para filtrar las celdas. Se usa con |
operator | El operador usado para combinar los criterios 1 y 2 al usar |
sub |
Propiedad usada por el filtro para realizar un filtro enriquecido en valores enriquecidos. |
values | Conjunto de valores que se van a usar como parte del |
Detalles de las propiedades
color
Cadena de color HTML que se usa para filtrar las celdas. Se usa con cellColor
y fontColor
filtrado.
color?: string;
Valor de propiedad
string
Comentarios
criterion1
Primer criterio usado para filtrar los datos. Se usa como operador en el caso de custom
filtrado. Por ejemplo, ">50" para números mayores que 50 o "=*s" para los valores que terminan en "s".
Se usa como número en el caso de los elementos/porcentajes superior/inferior (por ejemplo, "5" para los 5 elementos principales si filterOn
está establecido en topItems
).
criterion1?: string;
Valor de propiedad
string
Comentarios
criterion2
Segundo criterio usado para filtrar los datos. Solo se usa como operador en el caso de custom
filtrado.
criterion2?: string;
Valor de propiedad
string
Comentarios
dynamicCriteria
Criterios dinámicos del Excel.DynamicFilterCriteria
conjunto que se aplicarán en esta columna. Se usa con dynamic
el filtrado.
dynamicCriteria?: Excel.DynamicFilterCriteria | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" | "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" | "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday";
Valor de propiedad
Excel.DynamicFilterCriteria | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" | "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" | "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday"
Comentarios
filterOn
Propiedad usada por el filtro para determinar si los valores deben permanecer visibles.
filterOn: Excel.FilterOn | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" | "FontColor" | "Values" | "TopItems" | "TopPercent" | "Icon" | "Custom";
Valor de propiedad
Excel.FilterOn | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" | "FontColor" | "Values" | "TopItems" | "TopPercent" | "Icon" | "Custom"
Comentarios
[ Conjunto de API: ExcelApi 1.2 ]
Ejemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
// This function adds a percentage AutoFilter to the active worksheet
// and applies the filter to a column of the used range.
await Excel.run(async (context) => {
// Retrieve the active worksheet and the used range on that worksheet.
const sheet = context.workbook.worksheets.getActiveWorksheet();
const farmData = sheet.getUsedRange();
// Add a filter that will only show the rows with the top 50% of values in column 3.
sheet.autoFilter.apply(farmData, 3, {
criterion1: "50",
filterOn: Excel.FilterOn.topPercent
});
await context.sync();
});
icon
Icono usado para filtrar las celdas. Se usa con icon
el filtrado.
icon?: Excel.Icon;
Valor de propiedad
Comentarios
operator
El operador usado para combinar los criterios 1 y 2 al usar custom
el filtrado.
operator?: Excel.FilterOperator | "And" | "Or";
Valor de propiedad
Excel.FilterOperator | "And" | "Or"
Comentarios
subField
Propiedad usada por el filtro para realizar un filtro enriquecido en valores enriquecidos.
subField?: string;
Valor de propiedad
string
Comentarios
values
Conjunto de valores que se van a usar como parte del values
filtrado.
values?: Array<string | FilterDatetime>;
Valor de propiedad
Array<string | Excel.FilterDatetime>