Evento Report.ApplyFilter (Access)

Se produce cuando se aplica un filtro a un informe.

Sintaxis

más sencilla.ApplyFilter (Cancel, ApplyType)

expresión Variable que representa un objeto Report .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Cancel Obligatorio Número entero La opción determina si se produce el evento ApplyFilter. Si el argumento de Cancel se establece en True cancela el evento ApplyFilter y no se aplica el filtro al informe.
ApplyType Obligatorio Número entero Devuelve el tipo de filtro que se aplicó.

Comentarios

Para ejecutar una macro o procedimiento de evento cuando se produzca este evento, establezca la propiedad OnApplyFilter en el nombre de la macro o en [Procedimiento de evento].

Use el evento ApplyFilter para:

  • Asegúrese de que el filtro que se está aplicando es correcto. Por ejemplo, puede que quieras asegurarte de que cualquier filtro aplicado a un informe de Pedidos incluya criterios que restrinjan el campo FechaPedido . Para ello, compruebe el valor de la propiedad Filter o ServerFilter del informe para asegurarse de que este criterio se incluye en la expresión de la cláusula WHERE.

  • Cambiar la presentación del informe antes de que sea aplicado el filtro. Por ejemplo, cuando se aplica un filtro determinado, quizás desee deshabilitar u ocultar ciertos campos que no son apropiados para los registros que muestra el filtro.

  • Deshacer o cambiar las acciones que realizó cuando se produjo el evento Filter . Por ejemplo, puede deshabilitar u ocultar algunos controles en el informe cuando el usuario crea el filtro porque no desea que estos controles se incluyan en los criterios de filtro. Luego se pueden habilitar o mostrar estos controles después de ser aplicado el filtro.

Las acciones en la macro o el procedimiento de evento ApplyFilter se producen antes de aplicar o quitar el filtro, o después de cerrar la ventana Filtro avanzado/Ordenar, pero antes de que se vuelva a mostrar el informe. Los criterios que ha especificado en el filtro recién creado están disponibles para el procedimiento de evento o macro ApplyFilter como la configuración de la propiedad Filter o ServerFilter .

El evento ApplyFilter no se produce cuando el usuario realiza una de las siguientes opciones:

  • Aplica o quita un filtro usando las acciones ApplyFilter, OpenReport o ShowAllRecords en una macro, o sus métodos correspondientes del objeto DoCmd en Visual Basic.

  • Usa la acción Cerrar o el método Cerrar del objeto DoCmd para cerrar la ventana Filtro avanzado/Ordenar.

  • Establece la propiedad Filter o ServerFilter o la propiedad FilterOn en una macro o Visual Basic (aunque puede establecer estas propiedades en una macro o un procedimiento de evento ApplyFilter ).

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.