Événement Report.Filter (Access)

Article
04/07/2023

Se produit lorsque l’utilisateur ouvre une fenêtre de filtre en choisissant Filtre/Tri avancé.

Syntaxe

expression. Filter (Cancel, FilterType)

Expression Variable qui représente un objet Report .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Cancel	Obligatoire	Entier	Le paramètre détermine si vous souhaitez ouvrir la fenêtre de filtrage. La définition de l’argument Cancel sur True (1) empêche l’ouverture de la fenêtre de filtre. Vous pouvez également utiliser la méthode CancelEvent de l'objet DoCmd pour annuler l'ouverture de la fenêtre de filtrage.
FilterType	Obligatoire	Entier	La fenêtre de filtre de l'utilisateur essaie d'ouvrir. L'argument TypeFiltre peut être acFilterAdvanced.

Remarques

Pour exécuter une macro ou une procédure événementielle lorsque cet événement se produit, définissez la propriété OnFilter sur le nom de la macro ou [procédure événementielle].

Utilisez l’événement Filter pour :

Supprimer tout ancien filtre du rapport. Pour ce faire, définissez la propriété Filter ou ServerFilter du rapport à une chaîne de longueur nulle ("") dans la filtre de macro ou une procédure événementielle. Cela est particulièrement utile si vous souhaitez vous assurer que les critères superflus n’apparaissent pas dans le nouveau filtre. Par exemple, lorsque vous utilisez la fonctionnalité Filtrer par sélection , les critères que vous utilisez (le texte sélectionné dans le rapport) sont ajoutés à l’expression de clause WHERE de la propriété Filter ou ServerFilter et apparaissent dans la fenêtre Filtre/Tri avancé . Vous pouvez supprimer ces anciens critères à l'aide de l'événement Filter.
Entrez les paramètres par défaut pour le nouveau filtre. Pour ce faire, définissez la propriété Filter ou ServerFilter avec ces critères. Par exemple, vous pouvez souhaiter que tous les filtres d’un rapport Produits affichent uniquement les produits actuels (produits pour lesquels le contrôle Discontinued dans le rapport Produits n’est pas sélectionné).
Utiliser votre propre fenêtre filtre personnalisé au lieu d'une des fenêtres de filtre Microsoft Access. Lorsque l'événement Filter se produit, vous pouvez ouvrir votre propre formulaire et utiliser les entrées dans ce rapport pour définir la propriété Filter ou ServerFilter et filtrer le rapport d'origine. Lorsque l’utilisateur ferme ce formulaire personnalisé, définissez la propriété FilterOn ou ServerFilterByForm du rapport d’origine sur True (1) pour appliquer le filtre. L’annulation de l’événement Filter empêche l’ouverture de la fenêtre filtre Access.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.