AplicarFiltro (acción de macro)

Se aplica a: Access 2013, Office 2013

Puede usar la acción AplicarFiltro para aplicar un filtro, una consulta o una cláusula WHERE de SQL a una tabla, un formulario o un informe para restringir u ordenar los registros en la tabla, o los registros de la tabla subyacente o la consulta del formulario o informe. Para los informes, puede usar esta acción solo en una macro especificada por la propiedad del evento OnOpen del informe.

Nota:

[!NOTA] Puede usar esta acción para aplicar una cláusula WHERE de SQL cuando aplique un filtro de servidor. Un filtro de servidor no se puede aplicar a una fuente de registros de un procedimiento almacenado.

Configuración

La acción AplicarFiltro tiene los siguientes argumentos.

Argumento de la acción	Descripción
Nombre del filtro	El nombre de un filtro o una consulta que restringe u ordena los registros de una tabla, un formulario o un informe. Puede escribir el nombre de una consulta existente o un filtro que se guardó como una consulta en el cuadro Nombre del filtro de la sección Argumentos de acciones del panel Generador de macros. NOTA: Cuando se usa esta acción para aplicar un filtro de servidor, el argumento Nombre de filtro debe estar en blanco.
Condición WHERE	Una cláusula WHERE válida de SQL (sin la palabra WHERE) o una expresión que restringe los registros de la tabla, el formulario o el informe. NOTA: En una expresión de argumento Where Condition, el lado izquierdo de la expresión normalmente contiene un nombre de campo de la tabla o consulta subyacente para el formulario o informe. The right side of the expression typically contains the criteria you want to apply to this field to restrict or sort the records. Por ejemplo, los criterios pueden ser el nombre de un control en otro formulario que contenga el valor con el que desea que coincidan los registros en el primer formulario. El nombre del control debe ser completo, por ejemplo: ¡Formularios! formname! controlname Los nombres de campo deben estar rodeados de comillas dobles y los literales de cadena deben estar rodeados de comillas simples. La longitud máxima del argumento Where Condition es de 255 caracteres. If you need to enter a longer SQL WHERE clause, use the ApplyFilter method of the DoCmd object in a Visual Basic for Applications (VBA) module. You can enter SQL WHERE clause statements of up to 32,768 characters in VBA.

Nota:

Puede usar el argumento Filter Name si ya ha definido un filtro que proporciona los datos adecuados. El argumento WhereCondition puede usarlo para especificar directamente los criterios de restricción. Si usa ambos argumentos, Microsoft Office Access 2007 aplica la cláusula WHERE a los resultados del filtro. Debe usar uno o ambos argumentos.

Comentarios

Puede aplicar un filtro o una consulta a un formulario en la vista Formulario o la vista Hoja de datos.

El filtro y la condición WHERE que aplica se convierten en la configuración de la propiedad Filter o ServerFilter del formulario o el informe.

Para las tablas y los formularios, esta acción es similar a hacer clic en Aplicar filtro u orden o Aplicar filtro de servidor en el menú Registros. El comando de menú aplica el filtro creado más recientemente a la tabla o el formulario, mientras que la acción AplicarFiltro aplica un filtro o una consulta especificada.

En una base de datos de Access, si va a Filtro en el menú Registros y hace clic en Filtro u orden avanzado después de ejecutar la acción AplicarFiltro, la ventana Filtro u orden avanzado muestra los criterios de filtro que seleccionó con esta acción.

Para quitar un filtro y mostrar todos los registros para una tabla o un formulario en una Office Access 2007 base de datos, puede utilizar la acción MostrarTodosRegistros o el comando Quitar filtro u orden en el menú Registros. Para quitar un filtro en un proyecto de Access (.adp), puede volver a la ventana Filtro de servidor por formulario y quitar todos los criterios de filtros, y hacer clic en Aplicar filtro de servidor en el menú Registros de la barra de herramientas, o establecer la propiedad ServerFilterByForm a False (0).

Cuando guarda una tabla o un formulario, Access guarda cualquier filtro definido actualmente en ese objeto, pero no aplica el filtro automáticamente la próxima vez que se abre el objeto (aunque aplicará automáticamente cualquier orden que usted aplicó al objeto antes de guardarlo). Si desea aplicar un filtro automáticamente cuando se abre un formulario por primera vez, especifique una macro que contenga la acción AplicarFiltro o un procedimiento de evento que contenga el método ApplyFilter del objeto DoCmd como la configuración de la propiedad de evento OnOpen del formulario. También puede aplicar un filtro al utilizar la acción AbrirFormulario o AbrirInforme, o sus correspondientes métodos. Para aplicar un filtro automáticamente cuando se abre una tabla por primera vez, puede abrir la tabla con una macro que contenga la acción AbrirTabla, seguida inmediatamente por la acción AplicarFiltro.

Ejemplo

En el ejemplo siguiente se muestra cómo usar la acción ApplyFilter para filtrar el formulario frmFoods cuando se abre.

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
    
    ApplyFilter
        Filter Name
        Where Condition=[display_name] Link "*cheese*"
        Control Name