EstablecerFiltro (acción de macro)

Se aplica a: Access 2013, Office 2013

Puede utilizar la acción EstablecerFiltro para aplicar un filtro a los registros de la hoja de datos, formulario, informe o tabla que esté activo.

Configuración

La acción EstablecerFiltro utiliza los siguientes argumentos.

Argumento de la acción	Descripción
Nombre del filtro	Si se proporciona, el nombre de una consulta o de un filtro guardado como consulta. Este argumento o el argumento CondiciónWhere es necesario en una base de datos cliente. En una base de datos web, este argumento no está disponible.
Condición WHERE	Si se proporciona, una cláusula WHERE de SQL que restringe los registros en la hoja de datos, formulario, informe o tabla. En una base de datos web, se requiere este argumento.
Nombre del control	Si se proporciona, el nombre del control que corresponde al subformulario o subinforme que se va a filtrar. Si está vacío, se filtra el objeto actual.

Comentarios

En una base de datos web, el argumento Condición WHERE no puede empezar con un signo igual (=).

Al ejecutar esta acción, el filtro se aplica a la tabla, formulario, informe u hoja de datos (por ejemplo, el resultado de consulta) que está activo y tiene el enfoque.

La propiedad Filtro del objeto activo se utiliza para guardar el argumento CondiciónWhere y aplicarlo en un momento posterior. Los filtros se guardan con los objetos en los que se crean. Se cargan automáticamente cuando se abre el objeto, pero no se aplican automáticamente.

En una base de datos cliente, para aplicar un filtro automáticamente cuando se abre el objeto, establezca la propiedad FiltrarAlCargar en Verdadero.

En una base de datos web, para aplicar un filtro cuando se abre el objeto, agregue la acción EstablecerFiltro a una macro y agregue la macro al evento AlCargar del objeto.

Ejemplo

En el ejemplo siguiente se muestra cómo usar la acción SetFilter para filtrar el formulario en el que se define la macro.

Código de ejemplo proporcionado por la Referencia del programador de 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