Событие Report.ApplyFilter (Access)
Происходит при применении фильтра к отчету.
Синтаксис
expression. ApplyFilter (Cancel, ApplyType)
Выражение Переменная, представляющая объект Report .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| Отмена | Обязательный | Integer | Параметр определяет, возникает ли событие ApplyFilter . Если для аргумента Cancel задано значение True , событие ApplyFilter отменяется, а фильтр не применяется к отчету. |
| ApplyType | Обязательный | Integer | Возвращает тип примененного фильтра. |
Замечания
Чтобы выполнить макрос или процедуру события при возникновении этого события, задайте для свойства OnApplyFilter имя макроса или [Процедура события].
Используйте событие ApplyFilter , чтобы:
Убедитесь, что применяемый фильтр правильный. Например, может потребоваться убедиться, что любой фильтр, применяемый к отчету "Заказы" , содержит условия, ограничивающие поле OrderDate . Для этого проверьте значение свойства Filter или ServerFilter отчета, чтобы убедиться, что эти критерии включены в выражение предложения WHERE.
Измените отображение отчета перед применением фильтра. Например, при применении определенного фильтра может потребоваться отключить или скрыть некоторые поля, которые не подходят для записей, отображаемых этим фильтром.
Отмена или изменение действий, выполняемых при возникновении события Filter . Например, вы можете отключить или скрыть некоторые элементы управления в отчете, когда пользователь создает фильтр, так как вы не хотите, чтобы эти элементы управления включались в критерии фильтра. Затем эти элементы управления можно включить или отобразить после применения фильтра.
Действия в процедуре событий ApplyFilter или макросе выполняются перед применением или удалением фильтра или после закрытия окна Расширенный фильтр или сортировка, но до повторного воспроизведения отчета. Критерии, введенные во вновь созданном фильтре, доступны для процедуры события ApplyFilter или макроса в качестве параметра свойства Filter или ServerFilter .
Событие ApplyFilter не возникает, когда пользователь выполняет одно из следующих действий:
Применяет или удаляет фильтр с помощью действий ApplyFilter, OpenReport или ShowAllRecords в макросе или соответствующих методов объекта DoCmd в Visual Basic.
Использует действие Close или метод Close объекта DoCmd для закрытия окна Расширенный фильтр и сортировка.
Задает свойство Filter или ServerFilter или свойство FilterOn в макросе или Visual Basic (хотя эти свойства можно задать в процедуре события ApplyFilter или макросе).
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.