Puede usar la acción ApplyFilter para aplicar un filtro, un consulta o una cláusula WHERE de SQL a un tabla, formulario o informe para restringir u ordenar los registros de la tabla o los registros de la tabla o consulta subyacente del formulario o informe. Para los informes, puede usar esta acción solo en una macro especificada por la propiedad de evento OnOpen del informe.
Nota: Puede usar esta acción para aplicar una cláusula WHERE de SQL solo al aplicar un filtro de servidor. No se puede aplicar un filtro de servidor al origen de registros de un procedimiento almacenado.
Nota: La acción de macro AplicarFiltro no está disponible en las aplicaciones web de Access.
Configuración
La acción ApplyFilter tiene los siguientes argumentos:
|
Argumento de la acción |
Descripción |
|
Nombre del filtro |
El nombre de un filtro o consulta que restringe u ordena los registros de la tabla, formulario o informe. Puede escribir el nombre de una consulta existente o de un filtro guardado como consulta en el cuadro Nombre del filtro de la sección Argumentos de la acción del panel Generador de macros. Nota: Al usar esta acción para aplicar un filtro de servidor, el argumento Nombre de filtro debe estar en blanco. |
|
Where Condition |
Una cláusula WHERE de SQL válida (sin la palabra WHERE) o un expresión que restringe los registros de la tabla, formulario o 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. Normalmente, el lado derecho de la expresión contiene el criterio desea aplicar a este campo para restringir u ordenar los registros. Por ejemplo, los criterios pueden ser el nombre de un control de otro formulario que contiene el valor que desea que coincidan los registros del primer formulario. El nombre del control debe ser completo, por ejemplo: ¡Formularios! nombre_formulario! nombre del control Los nombres de campo deben estar entre comillas dobles y los literales de cadena deben estar entre comillas simples. La longitud máxima del argumento Where Condition es de 255 caracteres. Si necesita especificar una cláusula WHERE de SQL más larga, use el método ApplyFilter del objeto DoCmd en un módulo de Visual Basic para Aplicaciones (VBA). Puede escribir instrucciones de cláusula WHERE de SQL de hasta 32.768 caracteres en VBA. |
Nota: Puede usar el argumento Nombre de filtro si ya ha definido un filtro que proporciona los datos adecuados. Puede usar el argumento Where Condition para especificar directamente los criterios de restricción. Si usa ambos argumentos, Access aplica la cláusula WHERE a los resultados del filtro. Debe usar uno o ambos argumentos.
Comentarios
Puede aplicar un filtro o consulta a un formulario en vista Formulario o Vista de hoja de datos.
El filtro y la condición WHERE que se aplican se convierten en el valor de la propiedad Filter o ServerFilter del formulario o informe.
Para tablas y formularios, esta acción es similar a hacer clic en Aplicar filtro/ordenar o Aplicar filtro de servidor en el menú Registros . El comando de menú aplica el filtro creado más recientemente a la tabla o formulario, mientras que la acción AplicarFiltro aplica un filtro o consulta especificado.
En una base de datos de Access, si selecciona Filtrar en el menú Registros y, después, hace clic en Filtro u ordenación avanzada después de ejecutar la acción AplicarFiltro , la Ventana Filtro avanzado/Ordenar muestra los criterios de filtro que ha seleccionado con esta acción.
Para quitar un filtro y mostrar todos los registros de una tabla o formulario en una base de datos de Access, puede usar la acción MostrarTodosRegistros o el comando Quitar filtro/ordenar del 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 filtro y, a continuación, hacer clic en Aplicar filtro del servidor en el menú Registros de la barra de herramientas, o establecer la propiedad ServerFilterByForm en False (0).
Al guardar una tabla o formulario, Access guarda cualquier filtro definido actualmente en ese objeto, pero no lo aplicará automáticamente la próxima vez que se abra el objeto (aunque aplicará automáticamente cualquier orden que haya aplicado al objeto antes de guardarlo). Si desea aplicar un filtro automáticamente la primera vez que se abre un formulario, especifique una macro que contenga la acción ApplyFilter o un procedimiento de evento que contenga el método ApplyFilter del objeto DoCmd como el valor de la propiedad de evento OnOpen del formulario. También puede aplicar un filtro mediante la acción OpenForm o OpenReport , o sus métodos correspondientes. Para aplicar un filtro automáticamente la primera vez que se abre una tabla, puede abrir la tabla mediante una macro que contenga la acción OpenTable , seguida inmediatamente de la acción ApplyFilter .
Ejemplo
Aplicar un filtro mediante una macro
La macro siguiente contiene un conjunto de acciones, cada una de las cuales filtra los registros de un formulario de lista de teléfonos del cliente. Muestra el uso de las acciones ApplyFilter, ShowAllRecords y GoToControl . También muestra el uso de condiciones para determinar qué botón de alternancia de un grupo de opciones se ha seleccionado en el formulario. Cada fila de acciones está asociada con un botón de alternancia que selecciona el conjunto de registros empezando por A, B, C y así sucesivamente, o todos los registros. Esta macro debe adjuntarse al evento AfterUpdate del grupo de opciones CompanyNameFilter.
|
Condición |
Acción |
Argumentos: Configuración |
Comentario |
|
[CompanyNameFilters]=1 |
Applyfilter |
Where Condition: [CompanyName] Like "[Aàáâãä]*" |
Filtre por los nombres de compañías que comienzan por A, À, Á, Â, Ã o Ä. |
|
[CompanyNameFilters]=2 |
Applyfilter |
Where Condition: [CompanyName] Like "B*" |
Filtre por los nombres de compañías que comienzan por B. |
|
[CompanyNameFilters]=3 |
Applyfilter |
Where Condition: [CompanyName] Like "[CÇ]*" |
Filtre por nombres de compañías que empiecen por C o Ç. |
|
... Las filas de acción de D a Y tienen el mismo formato que A a C... |
|||
|
[CompanyNameFilters]=26 |
Applyfilter |
Where Condition: [CompanyName] Like "[ZÆØÅ]*" |
Filtre por los nombres de compañías que comienzan por Z, Æ, Ø o Å. |
|
[CompanyNameFilters]=27 |
ShowAllRecords |
Mostrar todos los registros. |
|
|
[RecordsetClone]. [RecordCount]>0 |
Gotocontrol |
Nombre del control: Nombre de la compañía |
Si se devuelven registros para la letra seleccionada, mueva el foco al control CompanyName. |
