Événement Report.Filter (Access)

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

Syntaxe

expression. Filtre (Annuler, FilterType)

expression Variable qui représente un objet Rapport .

Paramètres

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. Définir l’argument Annuler sur True (1) empêche la fenêtre de filtre de s’ouvrir. 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. Ceci est particulièrement utile si vous voulez vous assurer que des critères superflus n’apparaissent pas dans le nouveau filtre. Par exemple, lorsque vous utilisez la fonctionnalité Filtrer par sélection , le critère que vous utilisez (le texte sélectionné dans l’état) est ajouté à l’expression de clause WHERE de la propriété Filter ou ServerFilter et apparaît 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 Abandonné 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 la propriété ServerFilterByForm du rapport d’origine sur True (1) pour appliquer le filtre. L’annulation de l’événement Filtre empêche la fenêtre de filtre Access de s’ouvrir.

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.