Evento Report.ApplyFilter (Access)

Se produce cuando se aplica un filtro a un informe.

Sintaxis

expresión. 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 sea correcto. Por ejemplo, es posible que desee asegurarse de que cualquier filtro aplicado a un informe Pedidos incluya criterios que restrinjan el campo OrderDate . Para ello, compruebe el valor de la propiedad Filter o ServerFilter del informe para asegurarse de que estos criterios se incluyen 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 quiere 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 del procedimiento de evento o macro ApplyFilter se producen antes de aplicar o quitar el filtro, o después de cerrar la ventana Filtro o ordenación avanzada, pero antes de que se vuelva a mostrar el informe. Los criterios especificados en el filtro recién creado están disponibles para el procedimiento de evento ApplyFilter o la macro como el valor 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 mediante 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 Close del objeto DoCmd para cerrar la ventana Filtro o ordenación avanzados.

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

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.