SetFilter 宏操作

适用于:Access 2013、Office 2013

可以使用 SetFilter 操作向活动数据表、窗体、报表或表中的记录应用筛选器。

Setting

SetFilter 操作具有下列参数。

操作参数 说明
Filter Name 如果提供该参数,则会将查询或筛选器的名称另存为查询。 客户端数据库中必须包含该参数或 WhereCondition 参数。 在 Web 数据库中,此参数不可用。
Where 条件 如果提供该参数,则为可限制数据表、窗体、报表或表中记录的 SQL WHERE 子句。 在 Web 数据库中,此参数是必需的。
控件名称 如果提供该参数,则为与要筛选的子窗体或子报表相对应的控件的名称。 如果为空,则筛选当前对象。

备注

在 Web 数据库中,“Where Condition”参数不能以等号 (=) 开头。

在运行该操作时,将对处于活动状态且具有焦点的表、窗体、报表或数据表(如查询结果)应用筛选器。

活动对象的 Filter 属性用于保存 WhereCondition 参数并在以后应用该参数。 筛选器与在其中创建筛选器的对象一起保存。 在打开对象时会自动加载筛选器,但不会自动应用筛选器。

在客户端数据库中,若要在打开对象时自动应用筛选器,请将 FilterOnLoad 属性设置为 True。

在 Web 数据库中,若要在打开对象时自动应用筛选器,请将 SetFilter 操作设置为宏,并将该宏添加到对象的 OnLoad 事件中。

示例

以下示例演示如何使用 SetFilter 操作筛选在其中定义宏的窗体。

示例代码提供方:Microsoft Access 2010 程序员参考

    OpenForm
        Form Name sfrmFoods
        View Form
        Filter Name
        Where Condition
        Data Mode
        Window Mode Normal
    
    SetFilter
        Filter Name
        Where Condition =[display_name] Like "*cheese*"
        Control Name