Excel.Filter class

参考

包:: excel

管理表格列的筛选。

Extends: OfficeExtension.ClientObject

注解

属性

context	与对象关联的请求上下文。这会将加载项的进程连接到 Office 主机应用程序的进程。
criteria	给定列上当前应用的筛选器。

方法

apply(criteria)	在给定列中应用给定的筛选条件。
applyBottomItemsFilter(count)	将“Bottom Item”筛选器应用于列，以获取给定数量的元素。
applyBottomPercentFilter(percent)	将“Bottom Percent”筛选器应用于列，以获取给定比例的元素。
applyCellColorFilter(color)	将“Cell Color”筛选器应用于列，以获取给定颜色。
applyCustomFilter(criteria1, criteria2, oper)	将“图标”筛选器应用于给定条件字符串的列。
applyCustomFilter(criteria1, criteria2, operString)	将“图标”筛选器应用于给定条件字符串的列。
applyDynamicFilter(criteria)	将“Dynamic”筛选器应用于列。
applyDynamicFilter(criteriaString)	将“Dynamic”筛选器应用于列。
applyFontColorFilter(color)	将“Font Color”筛选器应用于列，以获取给定颜色。
applyIconFilter(icon)	将“图标”筛选器应用于给定图标的列。
applyTopItemsFilter(count)	将“Top Item”筛选器应用于列，以获取给定数量的元素。
applyTopPercentFilter(percent)	将“Top Percent”筛选器应用于列，以获取给定比例的元素。
applyValuesFilter(values)	将“Values”筛选器应用于列，获取给定值。
clear()	清除给定列上的 filter。
load(options)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
load(propertyNames)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
load(propertyNamesAndPaths)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
toJSON()	重写 JavaScript `toJSON()` 方法，以便在将 API 对象传递给 `JSON.stringify()`时提供更有用的输出。 `JSON.stringify` (，反过来又调用`toJSON`传递给它的对象的方法。) 而原始 Excel.Filter 对象是 API 对象，`toJSON`该方法返回一个纯 JavaScript 对象， (类型为 `Excel.Interfaces.FilterData`) ，其中包含从原始对象加载的任何子属性的浅表副本。

属性详细信息

context

与对象关联的请求上下文。这会将加载项的进程连接到 Office 主机应用程序的进程。

context: RequestContext;

属性值

Excel.RequestContext

criteria

给定列上当前应用的筛选器。

readonly criteria: Excel.FilterCriteria;

属性值

Excel.FilterCriteria

注解

[ API 集：ExcelApi 1.2 ]

方法详细信息

apply(criteria)

在给定列中应用给定的筛选条件。

apply(criteria: Excel.FilterCriteria): void;

参数

criteria: Excel.FilterCriteria

要应用的条件。

void

注解

[ API 集：ExcelApi 1.2 ]

applyBottomItemsFilter(count)

将“Bottom Item”筛选器应用于列，以获取给定数量的元素。

applyBottomItemsFilter(count: number): void;

参数

count: number

要显示的底部元素的数量。

void

注解

[ API 集：ExcelApi 1.2 ]

applyBottomPercentFilter(percent)

将“Bottom Percent”筛选器应用于列，以获取给定比例的元素。

applyBottomPercentFilter(percent: number): void;

参数

percent: number

要显示的底部元素的百分比。

void

注解

[ API 集：ExcelApi 1.2 ]

applyCellColorFilter(color)

将“Cell Color”筛选器应用于列，以获取给定颜色。

applyCellColorFilter(color: string): void;

参数

color: string

要显示的单元格的背景颜色。

void

注解

[ API 集：ExcelApi 1.2 ]

applyCustomFilter(criteria1, criteria2, oper)

将“图标”筛选器应用于给定条件字符串的列。

applyCustomFilter(criteria1: string, criteria2?: string, oper?: Excel.FilterOperator): void;

参数

criteria1: string

第一个条件字符串。

criteria2: string

可选。第二个条件字符串。

oper: Excel.FilterOperator

可选。说明这两个条件如何联接的运算符。

void

注解

[ API 集：ExcelApi 1.2 ]

applyCustomFilter(criteria1, criteria2, operString)

将“图标”筛选器应用于给定条件字符串的列。

applyCustomFilter(criteria1: string, criteria2?: string, operString?: "And" | "Or"): void;

参数

criteria1: string

第一个条件字符串。

criteria2: string

可选。第二个条件字符串。

operString: "And" | "Or"

可选。说明这两个条件如何联接的运算符。

void

注解

[ API 集：ExcelApi 1.2 ]

applyDynamicFilter(criteria)

将“Dynamic”筛选器应用于列。

applyDynamicFilter(criteria: Excel.DynamicFilterCriteria): void;

参数

criteria: Excel.DynamicFilterCriteria

要应用的动态条件。

void

注解

[ API 集：ExcelApi 1.2 ]

applyDynamicFilter(criteriaString)

将“Dynamic”筛选器应用于列。

applyDynamicFilter(criteriaString: "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"): void;

参数

criteriaString: "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"

要应用的动态条件。

void

注解

[ API 集：ExcelApi 1.2 ]

applyFontColorFilter(color)

将“Font Color”筛选器应用于列，以获取给定颜色。

applyFontColorFilter(color: string): void;

参数

color: string

要显示的单元格的字体颜色。

void

注解

[ API 集：ExcelApi 1.2 ]

applyIconFilter(icon)

将“图标”筛选器应用于给定图标的列。

applyIconFilter(icon: Excel.Icon): void;

参数

icon: Excel.Icon

要显示的单元格图标。

void

注解

[ API 集：ExcelApi 1.2 ]

applyTopItemsFilter(count)

将“Top Item”筛选器应用于列，以获取给定数量的元素。

applyTopItemsFilter(count: number): void;

参数

count: number

要显示的顶部元素的数量。

void

注解

[ API 集：ExcelApi 1.2 ]

applyTopPercentFilter(percent)

将“Top Percent”筛选器应用于列，以获取给定比例的元素。

applyTopPercentFilter(percent: number): void;

参数

percent: number

要显示的顶部元素的百分比。

void

注解

[ API 集：ExcelApi 1.2 ]

applyValuesFilter(values)

将“Values”筛选器应用于列，获取给定值。

applyValuesFilter(values: Array<string | FilterDatetime>): void;

参数

values: Array<string | Excel.FilterDatetime>

要显示的值的列表。这必须是字符串数组或对象的数组 Excel.FilterDateTime 。

void

注解

[ API 集：ExcelApi 1.2 ]

clear()

清除给定列上的 filter。

clear(): void;

void

注解

[ API 集：ExcelApi 1.2 ]

load(options)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(options?: Excel.Interfaces.FilterLoadOptions): Excel.Filter;

参数

options: Excel.Interfaces.FilterLoadOptions

提供要加载对象的属性的选项。

Excel.Filter

load(propertyNames)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(propertyNames?: string | string[]): Excel.Filter;

参数

propertyNames: string | string[]

逗号分隔的字符串或指定要加载的属性的字符串数组。

Excel.Filter

load(propertyNamesAndPaths)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.Filter;

参数

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select 是一个逗号分隔的字符串，指定要加载的属性，是 propertyNamesAndPaths.expand 一个逗号分隔的字符串，指定要加载的导航属性。

Excel.Filter

toJSON()

重写 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 JSON.stringify (，反过来又调用toJSON传递给它的对象的方法。) 而原始 Excel.Filter 对象是 API 对象，toJSON该方法返回一个纯 JavaScript 对象， (类型为 Excel.Interfaces.FilterData) ，其中包含从原始对象加载的任何子属性的浅表副本。

toJSON(): Excel.Interfaces.FilterData;

Excel.Interfaces.FilterData

Excel.Filter class

注解

属性

方法

属性详细信息

context

属性值

criteria

属性值

注解

方法详细信息

apply(criteria)

参数

返回

注解

applyBottomItemsFilter(count)

参数

返回

注解

applyBottomPercentFilter(percent)

参数

返回

注解

applyCellColorFilter(color)

参数

返回

注解

applyCustomFilter(criteria1, criteria2, oper)

参数

返回

注解

applyCustomFilter(criteria1, criteria2, operString)

参数

返回

注解

applyDynamicFilter(criteria)

参数

返回

注解

applyDynamicFilter(criteriaString)

参数

返回

注解

applyFontColorFilter(color)

参数

返回

注解

applyIconFilter(icon)

参数

返回

注解

applyTopItemsFilter(count)

参数

返回

注解

applyTopPercentFilter(percent)

参数

返回

注解

applyValuesFilter(values)

参数

返回

注解

clear()

返回

注解

load(options)

参数

返回

load(propertyNames)

参数

返回

load(propertyNamesAndPaths)

参数

返回

toJSON()

返回

反馈

其他资源