Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Se produit lorsqu'un filtre est appliqué à un état.
Syntaxe
expression. ApplyFilter (Cancel, ApplyType)
expression Variable qui représente un objet Report .
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| Cancel | Obligatoire | Integer | Le paramètre détermine si l'événement ApplyFilter se produit. La définition de l'argument Cancel sur True annule l'événement ApplyFilter et le filtre n'est pas appliqué au rapport. |
| ApplyType | Obligatoire | Integer | Renvoie le type de filtre appliqué. |
Remarques
Pour exécuter une macro ou une procédure événementielle lorsque cet événement se produit, définissez la propriété OnApplyFilter sur le nom de la macro ou [Procédure événementielle].
Utilisez l’événement ApplyFilter pour :
Assurez-vous que le filtre appliqué est correct. Par exemple, vous pouvez être sûr que tout filtre appliqué à un rapport Commandes inclut des critères limitant le champ OrderDate . Pour ce faire, case activée la valeur de la propriété Filter ou ServerFilter du rapport pour vous assurer que ce critère est inclus dans l’expression de clause WHERE.
Modifier l'affichage de l'état avant que le filtre ne soit appliqué. Par exemple, lorsque vous appliquez un certain filtre, vous voulez peut-être désactiver ou masquer des champs qui ne sont pas appropriés pour les enregistrements affichés par le filtre en question.
Annuler ou modifier les actions que vous avez effectuées lorsque l’événement Filter s’est produit. Par exemple, vous pouvez désactiver ou masquer certains contrôles sur le rapport lorsque l’utilisateur crée le filtre, car vous ne souhaitez pas que ces contrôles soient inclus dans les critères de filtre. Vous pouvez ensuite activer ou afficher ces contrôles une fois que le filtre est appliqué.
Les actions dans la macro ou la procédure événementielle ApplyFilter se produisent avant l’application ou la suppression du filtre, ou après la fermeture de la fenêtre Filtre/tri avancé, mais avant que le rapport ne soit réaffiché. Les critères que vous avez entrés dans le filtre nouvellement créé sont disponibles pour la macro ou la procédure événementielle ApplyFilter en tant que paramètre de la propriété Filter ou ServerFilter .
L'événement ApplyFilter ne se produit pas lorsque l'utilisateur effectue une des opérations suivantes :
Applique ou supprime un filtre à l’aide des actions ApplyFilter, OpenReport ou ShowAllRecords dans une macro, ou de leurs méthodes correspondantes de l’objet DoCmd dans Visual Basic.
Utilise l'action Close ou la méthode Close de l'objet DoCmd pour refermer la fenêtre Filtre/tri avancé.
Définit la propriété Filter ou ServerFilter ou la propriété FilterOn dans une macro ou Visual Basic (bien que vous puissiez définir ces propriétés dans une procédure événementielle Ou une macro ApplyFilter ).
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.